Skip to content

🎬 视频模型 higgsfield

  • 2025.05.21 本站已经支持 视频模型 higgsfield
  • 可支持模版丰富
  • 仅支持 图生视频
  • 计费是按次数,一次一个视频 涉及到 model

计费

    1. modellite 为基数价格
    1. standard 则是基数价格的 2 倍
    1. turbo 则是基数价格的 1.4 倍

Higgsfield API

  • 约定 header 带上 Authorization: Bearer your-key

1.生成任务

post https://api.openai-hk.com/higgsfield/generate

shell
curl --request POST \
  --url https://api.openai-hk.com/higgsfield/generate  \
  --header 'Authorization: Bearer hk-your-key' \
  --header 'Content-Type: application/json' \
  --data '{
    "model": "standard",
    "motion_id": "cd5bfd11-5a1a-46e0-9294-b22b0b733b1e",
    "prompt": "正在吃饭",
    "enhance_prompt": true,
    "seed": 374487,
    "width": 736,
    "height": 1312,
    "image":["https://media.pixverse.ai/asset/media/fusion4_1.jpg","https://media.pixverse.ai/asset/media/fusion4_2.png" ]
}'
curl --request POST \
  --url https://api.openai-hk.com/higgsfield/generate  \
  --header 'Authorization: Bearer hk-your-key' \
  --header 'Content-Type: application/json' \
  --data '{
    "model": "standard",
    "motion_id": "cd5bfd11-5a1a-46e0-9294-b22b0b733b1e",
    "prompt": "正在吃饭",
    "enhance_prompt": true,
    "seed": 374487,
    "width": 736,
    "height": 1312,
    "image":["https://media.pixverse.ai/asset/media/fusion4_1.jpg","https://media.pixverse.ai/asset/media/fusion4_2.png" ]
}'

请求体

json
{
  "model": "standard",
  "motion_id": "cd5bfd11-5a1a-46e0-9294-b22b0b733b1e",
  "prompt": "正在吃饭",
  "enhance_prompt": true,
  "seed": 374487,
  "width": 736,
  "height": 1312,
  "image": [
    "https://media.pixverse.ai/asset/media/fusion4_1.jpg",
    "https://media.pixverse.ai/asset/media/fusion4_2.png"
  ]
}
{
  "model": "standard",
  "motion_id": "cd5bfd11-5a1a-46e0-9294-b22b0b733b1e",
  "prompt": "正在吃饭",
  "enhance_prompt": true,
  "seed": 374487,
  "width": 736,
  "height": 1312,
  "image": [
    "https://media.pixverse.ai/asset/media/fusion4_1.jpg",
    "https://media.pixverse.ai/asset/media/fusion4_2.png"
  ]
}

关键字段说明

字段类型说明
modelstring模型类型 standard lite turbo
motion_idstring选择动作 动作模版 可以到官网 参考拿到 cd5bfd11-5a1a-46e0-9294-b22b0b733b1e
promptstring图生视频的提示词
enhance_promptboolean是否增强提示词
seednumber种子 1-1000000 不在这个范围内会报错
widthnumber视频宽度
heightnumber视频高度
imagestring[]视频帧图片地址 支持 url 和 base64 必须是最少 1 张、最多 2 张图
  • 返回体
  • 得到 id 供给后面查询任务的 task_id
json
{
  "id": "aca6c73e-aa4c-47bb-aa62-a100a0f7dd22"
}
{
  "id": "aca6c73e-aa4c-47bb-aa62-a100a0f7dd22"
}

2.获取任务

get https://api.openai-hk.com/higgsfield/feed/{task_id}

shell
curl --request GET \
  --url https://api.openai-hk.com/higgsfield/feed/aca6c73e-aa4c-47bb-aa62-a100a0f7dd22 \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer hk-your-key'
curl --request GET \
  --url https://api.openai-hk.com/higgsfield/feed/aca6c73e-aa4c-47bb-aa62-a100a0f7dd22 \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer hk-your-key'

返回体

json
{
  "id": "aca6c73e-aa4c-47bb-aa62-a100a0f7dd22",
  "type": "image2video",
  "project_id": "41ff94b3-91b5-424a-a455-0ecef47c9b77",
  "created_at": 1747790390.044471,
  "params": {
    "prompt": "The white cat sits poised, its large round eyes staring intently forward as it prepares to eat. Suddenly, a hand reaches from the side, presenting a morsel of food that glistens under the soft lighting. The moment of contact triggers the slow-motion effect, capturing the tiny ripple in the cat's fur and the quivering of its whiskers. Time stretches as the cat's expression shifts from curiosity to delight, revealing its delicate vulnerability. Flecks of dust hang suspended in the air, illuminated by warm highlights, while the camera slowly zooms in to showcase the intensity of the exchange.",
    "input_image": {
      "id": "657edc5b-0f39-43b6-8706-676d60366d7d",
      "url": "https://d2ol7oe51mr4n9.cloudfront.net/anon_user_id/657edc5b-0f39-43b6-8706-676d60366d7d.jpeg",
      "type": "media_input"
    },
    "seed": 374487,
    "steps": 20,
    "guide_scale": 6,
    "frames": 81,
    "width": 736,
    "height": 1312,
    "strength": 1,
    "model": "standard",
    "motion_id": "cd5bfd11-5a1a-46e0-9294-b22b0b733b1e",
    "motion": {
      "id": "cd5bfd11-5a1a-46e0-9294-b22b0b733b1e",
      "url": "https://d1xarpci4ikg0w.cloudfront.net/4c75250f-a508-4d36-b092-25cc0837f127.webp",
      "name": "Face Punch"
    },
    "enhance_prompt": true,
    "guide_end": 1,
    "is_chain": false,
    "chain_sample": null,
    "input_image_end": null,
    "product_placement_sample": null
  },
  "jobs": [
    {
      "id": "f0204af5-1b7e-4c43-a113-191ca66acd31",
      "status": "completed",
      "result": {
        "type": "video",
        "url": "https://d8j0ntlcm91z4.cloudfront.net/user_2xIzuhTaLzSSkbGluAOou1fpp32/5c0ac5f8-b3ff-4161-a77b-c248f02bfeca.mp4"
      },
      "results": {
        "raw": {
          "type": "video",
          "url": "https://d8j0ntlcm91z4.cloudfront.net/user_2xIzuhTaLzSSkbGluAOou1fpp32/5c0ac5f8-b3ff-4161-a77b-c248f02bfeca.mp4"
        },
        "min": {
          "type": "video",
          "url": "https://d8j0ntlcm91z4.cloudfront.net/user_2xIzuhTaLzSSkbGluAOou1fpp32/5c0ac5f8-b3ff-4161-a77b-c248f02bfeca_min.mp4"
        }
      },
      "board_ids": [],
      "meta": {
        "duration": 5
      }
    }
  ]
}
{
  "id": "aca6c73e-aa4c-47bb-aa62-a100a0f7dd22",
  "type": "image2video",
  "project_id": "41ff94b3-91b5-424a-a455-0ecef47c9b77",
  "created_at": 1747790390.044471,
  "params": {
    "prompt": "The white cat sits poised, its large round eyes staring intently forward as it prepares to eat. Suddenly, a hand reaches from the side, presenting a morsel of food that glistens under the soft lighting. The moment of contact triggers the slow-motion effect, capturing the tiny ripple in the cat's fur and the quivering of its whiskers. Time stretches as the cat's expression shifts from curiosity to delight, revealing its delicate vulnerability. Flecks of dust hang suspended in the air, illuminated by warm highlights, while the camera slowly zooms in to showcase the intensity of the exchange.",
    "input_image": {
      "id": "657edc5b-0f39-43b6-8706-676d60366d7d",
      "url": "https://d2ol7oe51mr4n9.cloudfront.net/anon_user_id/657edc5b-0f39-43b6-8706-676d60366d7d.jpeg",
      "type": "media_input"
    },
    "seed": 374487,
    "steps": 20,
    "guide_scale": 6,
    "frames": 81,
    "width": 736,
    "height": 1312,
    "strength": 1,
    "model": "standard",
    "motion_id": "cd5bfd11-5a1a-46e0-9294-b22b0b733b1e",
    "motion": {
      "id": "cd5bfd11-5a1a-46e0-9294-b22b0b733b1e",
      "url": "https://d1xarpci4ikg0w.cloudfront.net/4c75250f-a508-4d36-b092-25cc0837f127.webp",
      "name": "Face Punch"
    },
    "enhance_prompt": true,
    "guide_end": 1,
    "is_chain": false,
    "chain_sample": null,
    "input_image_end": null,
    "product_placement_sample": null
  },
  "jobs": [
    {
      "id": "f0204af5-1b7e-4c43-a113-191ca66acd31",
      "status": "completed",
      "result": {
        "type": "video",
        "url": "https://d8j0ntlcm91z4.cloudfront.net/user_2xIzuhTaLzSSkbGluAOou1fpp32/5c0ac5f8-b3ff-4161-a77b-c248f02bfeca.mp4"
      },
      "results": {
        "raw": {
          "type": "video",
          "url": "https://d8j0ntlcm91z4.cloudfront.net/user_2xIzuhTaLzSSkbGluAOou1fpp32/5c0ac5f8-b3ff-4161-a77b-c248f02bfeca.mp4"
        },
        "min": {
          "type": "video",
          "url": "https://d8j0ntlcm91z4.cloudfront.net/user_2xIzuhTaLzSSkbGluAOou1fpp32/5c0ac5f8-b3ff-4161-a77b-c248f02bfeca_min.mp4"
        }
      },
      "board_ids": [],
      "meta": {
        "duration": 5
      }
    }
  ]
}

关键字说明

字段类型说明
jobs[0].statusstring状态 queued in_progress completed
jobs[0].result.urlstring最终结果

3.模版参考

json
[
  {
    "id": "f226ac67-43d3-4726-ad9c-132608bda8b3",
    "name": "Eyes In",
    "media": {
      "width": 320,
      "height": 202,
      "url": "https://d1xarpci4ikg0w.cloudfront.net/a8caa3db-bcf2-4e30-b5fe-37fafdd59140.webp",
      "type": "animated"
    },
    "priority": -1,
    "tags": [],
    "params": null,
    "categories": ["vfx", "epic_camera_control"]
  },
  {
    "id": "2a5d8f86-aef3-4b34-b5ee-fb2020daa131",
    "name": "Arc Left",
    "media": {
      "width": 320,
      "height": 236,
      "url": "https://d1xarpci4ikg0w.cloudfront.net/20635190-872d-41fc-ad79-78ceef343726.webp",
      "type": "animated"
    },
    "priority": 0,
    "tags": ["top_choice"],
    "params": null,
    "categories": ["epic_camera_control", "trending"]
  },
  {
    "id": "017ae2b7-bcff-42ef-863e-6e198f96c3ec",
    "name": "Turning Metal + Melting",
    "media": {
      "width": 320,
      "height": 182,
      "url": "https://d1xarpci4ikg0w.cloudfront.net/9a49c573-c91d-410d-b851-b06f0c06d3b9.webp",
      "type": "animated"
    },
    "priority": 0,
    "tags": ["mix"],
    "params": {
      "motions": [
        {
          "id": "46e23a6b-1047-40f1-9cf5-33f5f55ddf2e",
          "type": "motion",
          "strength": 0.85
        },
        {
          "id": "d8c13031-7117-4a3d-9a30-6a00d0d408b4",
          "type": "motion",
          "strength": 0.6
        }
      ]
    },
    "mix": [
      {
        "id": "46e23a6b-1047-40f1-9cf5-33f5f55ddf2e",
        "name": "Turning Metal",
        "media": {
          "width": 320,
          "height": 424,
          "url": "https://d1xarpci4ikg0w.cloudfront.net/d44a136d-8b78-49c8-bf3d-889e5f30c547.webp",
          "type": "animated"
        }
      },
      {
        "id": "d8c13031-7117-4a3d-9a30-6a00d0d408b4",
        "name": "Melting",
        "media": {
          "width": 320,
          "height": 182,
          "url": "https://d1xarpci4ikg0w.cloudfront.net/208e5e19-956c-48a2-afb7-8ca822c29a23.webp",
          "type": "animated"
        }
      }
    ]
  },
  {
    "id": "6f06f47e-922e-4660-9fe9-754e4be69696",
    "name": "3D Rotation",
    "media": {
      "width": 320,
      "height": 320,
      "url": "https://d1xarpci4ikg0w.cloudfront.net/96ccaa14-59c4-49df-a91d-aa898794b32d.webp",
      "type": "animated"
    },
    "priority": 0,
    "tags": ["new"],
    "params": null,
    "categories": []
  },
  {
    "id": "9ac92661-d0f7-4b5e-85b1-f3654cb4627b",
    "name": "Moonwalk Left",
    "media": {
      "width": 320,
      "height": 424,
      "url": "https://d1xarpci4ikg0w.cloudfront.net/9fdd4463-2e38-4419-a956-aa9645a9343e.webp",
      "type": "animated"
    },
    "priority": 0,
    "tags": [],
    "params": null,
    "categories": ["catch_the_pulse"]
  },
  {
    "id": "b157f3d0-f3d5-4b34-8fd1-ee034c43dd1c",
    "name": "Medusa Gorgona",
    "media": {
      "width": 320,
      "height": 210,
      "url": "https://d1xarpci4ikg0w.cloudfront.net/f671aafc-1e4b-4ab4-916d-0736b3edb8c2.webp",
      "type": "animated"
    },
    "priority": 0,
    "tags": ["new"],
    "params": null,
    "categories": []
  },
  {
    "id": "c99c3417-31d0-47f0-8cc9-1b25dc5de023",
    "name": "Snowboard Powder",
    "media": {
      "width": 320,
      "height": 242,
      "url": "https://d1xarpci4ikg0w.cloudfront.net/b928a301-9609-4948-a045-5a4a79481b5c.webp",
      "type": "animated"
    },
    "priority": 0,
    "tags": [],
    "params": null,
    "categories": ["catch_the_pulse"]
  },
  {
    "id": "9312c53a-f191-4aab-94fb-6b1dbdfdc946",
    "name": "Bullet Time",
    "media": {
      "width": 320,
      "height": 320,
      "url": "https://d1xarpci4ikg0w.cloudfront.net/897e662e-7d15-4ba2-8f2c-dc4c772e347e.webp",
      "type": "animated"
    },
    "priority": 0,
    "tags": ["top_choice"],
    "params": null,
    "categories": ["epic_camera_control", "trending"]
  },
  {
    "id": "c9da59da-aabd-4fd5-a7c8-f09a1d9f9f50",
    "name": "Moonwalk Right",
    "media": {
      "width": 320,
      "height": 210,
      "url": "https://d1xarpci4ikg0w.cloudfront.net/7462c8c3-5c55-43e6-9ad5-42e7e07ddce8.webp",
      "type": "animated"
    },
    "priority": 0,
    "tags": [],
    "params": null,
    "categories": ["catch_the_pulse"]
  },
  {
    "id": "cd5bfd11-5a1a-46e0-9294-b22b0b733b1e",
    "name": "Face Punch",
    "media": {
      "width": 320,
      "height": 242,
      "url": "https://d1xarpci4ikg0w.cloudfront.net/4c75250f-a508-4d36-b092-25cc0837f127.webp",
      "type": "animated"
    },
    "priority": 1,
    "tags": ["top_choice"],
    "params": null,
    "categories": ["vfx", "trending"]
  },
  {
    "id": "b120f292-74e3-4878-817b-626e203f8a92",
    "name": "Incline",
    "media": {
      "width": 320,
      "height": 236,
      "url": "https://d1xarpci4ikg0w.cloudfront.net/bb149d66-0c52-4a7d-afd1-42892f2f6aff.webp",
      "type": "animated"
    },
    "priority": 1,
    "tags": ["new"],
    "params": null,
    "categories": []
  },
  {
    "id": "007f9809-c63e-4f65-9976-3001cf699784",
    "name": "Datamosh",
    "media": {
      "width": 320,
      "height": 236,
      "url": "https://d1xarpci4ikg0w.cloudfront.net/602fb0d0-ee72-4f16-bc26-93feb5283b94.webp",
      "type": "animated"
    },
    "priority": 1,
    "tags": ["new"],
    "params": null,
    "categories": []
  },
  {
    "id": "17a55db6-8775-4a9f-a2c9-d0d373bee590",
    "name": "Boxing",
    "media": {
      "width": 320,
      "height": 210,
      "url": "https://d1xarpci4ikg0w.cloudfront.net/4921b0b7-b524-4365-955a-39949123aaaa.webp",
      "type": "animated"
    },
    "priority": 1,
    "tags": [],
    "params": null,
    "categories": ["catch_the_pulse"]
  },
  {
    "id": "6308a9a6-877d-4fb1-be21-481638833983",
    "name": "Morphskin",
    "media": {
      "width": 320,
      "height": 236,
      "url": "https://d1xarpci4ikg0w.cloudfront.net/01e0631b-8c10-4441-8617-80c638eb29f8.webp",
      "type": "animated"
    },
    "priority": 2,
    "tags": ["new"],
    "params": null,
    "categories": []
  },
  {
    "id": "dbf3fbc1-f69c-4904-a063-104cf2998a40",
    "name": "Head Explosion",
    "media": {
      "width": 320,
      "height": 320,
      "url": "https://d1xarpci4ikg0w.cloudfront.net/63ebed42-5844-4f9f-ae77-a8ce3eefea3d.webp",
      "type": "animated"
    },
    "priority": 2,
    "tags": ["new"],
    "params": null,
    "categories": []
  },
  {
    "id": "ed15397e-0a3d-49e3-add4-b9529698a8ad",
    "name": "Melting",
    "media": {
      "width": 320,
      "height": 486,
      "url": "https://d1xarpci4ikg0w.cloudfront.net/b54b7f22-f4cf-4c9e-928c-fa6a8e6a3a9c.webp",
      "type": "animated"
    },
    "priority": 2,
    "tags": [],
    "params": null,
    "categories": ["vfx", "new"]
  },
  {
    "id": "c2ece0f5-8775-4f8e-924b-b134907b51ad",
    "name": "Baseball Kick",
    "media": {
      "width": 320,
      "height": 240,
      "url": "https://d1xarpci4ikg0w.cloudfront.net/29e0b451-1c9b-4075-85c7-93474a8977cb.webp",
      "type": "animated"
    },
    "priority": 2,
    "tags": [],
    "params": null,
    "categories": ["catch_the_pulse"]
  },
  {
    "id": "0bdbf318-f918-4f9b-829a-74cab681d806",
    "name": "Arc Right",
    "media": {
      "width": 320,
      "height": 424,
      "url": "https://d1xarpci4ikg0w.cloudfront.net/f97e1093-b61a-4bbd-abed-4318fc1249e8.webp",
      "type": "animated"
    },
    "priority": 2,
    "tags": ["top_choice"],
    "params": null,
    "categories": ["epic_camera_control", "trending"]
  },
  {
    "id": "06b50d3a-65a9-432b-bf0b-493fc3dcc006",
    "name": "Set on Fire",
    "media": {
      "width": 320,
      "height": 242,
      "url": "https://d1xarpci4ikg0w.cloudfront.net/a0c9ff96-e3a7-4454-9099-a1f734f50c9e.webp",
      "type": "animated"
    },
    "priority": 2,
    "tags": [],
    "params": null,
    "categories": ["vfx", "new"]
  },
  {
    "id": "e974bca9-c9eb-4cc8-9318-5676cc110f17",
    "name": "Building Explosion",
    "media": {
      "width": 320,
      "height": 182,
      "url": "https://d1xarpci4ikg0w.cloudfront.net/5d4e4106-9149-4761-9973-00cb66253357.webp",
      "type": "animated"
    },
    "priority": 2,
    "tags": ["top_choice"],
    "params": null,
    "categories": ["vfx"]
  },
  {
    "id": "46e23a6b-1047-40f1-9cf5-33f5f55ddf2e",
    "name": "Turning Metal",
    "media": {
      "width": 320,
      "height": 424,
      "url": "https://d1xarpci4ikg0w.cloudfront.net/d44a136d-8b78-49c8-bf3d-889e5f30c547.webp",
      "type": "animated"
    },
    "priority": 3,
    "tags": [],
    "params": null,
    "categories": ["vfx", "new"]
  },
  {
    "id": "4e981984-1cdc-4b96-a2b1-1a7c1ecb822d",
    "name": "Disintegration",
    "media": {
      "width": 320,
      "height": 416,
      "url": "https://d1xarpci4ikg0w.cloudfront.net/634ede39-bc1f-4635-b4bc-eee2d87a4735.webp",
      "type": "animated"
    },
    "priority": 3,
    "tags": [],
    "params": null,
    "categories": ["vfx", "trending"]
  },
  {
    "id": "aab8440c-0d65-4554-b88a-7a9a5e084b6e",
    "name": "Static",
    "media": {
      "width": 320,
      "height": 486,
      "url": "https://d1xarpci4ikg0w.cloudfront.net/b9ee21e0-fa8a-4874-be6d-00f9763a9920.webp",
      "type": "animated"
    },
    "priority": 3,
    "tags": ["top_choice"],
    "params": null,
    "categories": ["basic_camera_control"]
  },
  {
    "id": "86f0a592-515a-4a10-bffe-910c6282cb44",
    "name": "Skateboard Glide",
    "media": {
      "width": 320,
      "height": 242,
      "url": "https://d1xarpci4ikg0w.cloudfront.net/20fb4b13-541c-43c8-ac91-45a0614889a2.webp",
      "type": "animated"
    },
    "priority": 3,
    "tags": [],
    "params": null,
    "categories": ["catch_the_pulse"]
  },
  {
    "id": "6cf1eea1-294a-482b-a43e-98336bfbe381",
    "name": "Symbiote",
    "media": {
      "width": 320,
      "height": 242,
      "url": "https://d1xarpci4ikg0w.cloudfront.net/a6005200-5d6e-42c0-943c-a10e749bbe8a.webp",
      "type": "animated"
    },
    "priority": 3,
    "tags": ["new"],
    "params": null,
    "categories": []
  },
  {
    "id": "c839c180-cf06-4924-8ad5-ddea18c97122",
    "name": "Thunder God + Turning Metal",
    "media": {
      "width": 320,
      "height": 242,
      "url": "https://d1xarpci4ikg0w.cloudfront.net/a90c9740-cf9c-4c7e-acfd-f5b54045a9f1.webp",
      "type": "animated"
    },
    "priority": 4,
    "tags": ["mix"],
    "params": {
      "motions": [
        {
          "id": "ca0568ee-6a0f-4134-a4ee-97dfe44753ba",
          "type": "motion",
          "strength": 0.65
        },
        {
          "id": "46e23a6b-1047-40f1-9cf5-33f5f55ddf2e",
          "type": "motion",
          "strength": 0.8
        }
      ]
    },
    "mix": [
      {
        "id": "ca0568ee-6a0f-4134-a4ee-97dfe44753ba",
        "name": "Thunder God",
        "media": {
          "width": 320,
          "height": 242,
          "url": "https://d1xarpci4ikg0w.cloudfront.net/1abf9bb7-8dfd-42b1-80a8-9ebd48e10487.webp",
          "type": "animated"
        }
      },
      {
        "id": "46e23a6b-1047-40f1-9cf5-33f5f55ddf2e",
        "name": "Turning Metal",
        "media": {
          "width": 320,
          "height": 424,
          "url": "https://d1xarpci4ikg0w.cloudfront.net/d44a136d-8b78-49c8-bf3d-889e5f30c547.webp",
          "type": "animated"
        }
      }
    ]
  },
  {
    "id": "c7b26f66-9d34-44d7-9b18-c8e679e6a391",
    "name": "Ski Carving",
    "media": {
      "width": 320,
      "height": 242,
      "url": "https://d1xarpci4ikg0w.cloudfront.net/1b92b32b-590a-450f-8966-fab196494e33.webp",
      "type": "animated"
    },
    "priority": 4,
    "tags": [],
    "params": null,
    "categories": ["catch_the_pulse"]
  },
  {
    "id": "5eb82f94-2b98-4e4a-ab4b-ee6c872fb2c7",
    "name": "FPV Drone",
    "media": {
      "width": 320,
      "height": 180,
      "url": "https://d1xarpci4ikg0w.cloudfront.net/a6bbb172-ecff-4dcb-87b2-18a87898febd.webp",
      "type": "animated"
    },
    "priority": 5,
    "tags": [],
    "params": null,
    "categories": ["epic_camera_control"]
  },
  {
    "id": "b6eb17bb-d336-46db-99c6-34f01ae754f3",
    "name": "Agent Reveal",
    "media": {
      "width": 320,
      "height": 182,
      "url": "https://d1xarpci4ikg0w.cloudfront.net/4602e616-84b7-4348-a48d-aa255c974329.webp",
      "type": "animated"
    },
    "priority": 5,
    "tags": [],
    "params": null,
    "categories": ["vfx", "new"]
  },
  {
    "id": "a0a7c624-cf2a-4204-a9f8-60623d4a7383",
    "name": "Catwalk",
    "media": {
      "width": 320,
      "height": 242,
      "url": "https://d1xarpci4ikg0w.cloudfront.net/d7df6057-5141-4503-8f77-d784c8c90164.webp",
      "type": "animated"
    },
    "priority": 5,
    "tags": [],
    "params": null,
    "categories": ["catch_the_pulse"]
  }
]
[
  {
    "id": "f226ac67-43d3-4726-ad9c-132608bda8b3",
    "name": "Eyes In",
    "media": {
      "width": 320,
      "height": 202,
      "url": "https://d1xarpci4ikg0w.cloudfront.net/a8caa3db-bcf2-4e30-b5fe-37fafdd59140.webp",
      "type": "animated"
    },
    "priority": -1,
    "tags": [],
    "params": null,
    "categories": ["vfx", "epic_camera_control"]
  },
  {
    "id": "2a5d8f86-aef3-4b34-b5ee-fb2020daa131",
    "name": "Arc Left",
    "media": {
      "width": 320,
      "height": 236,
      "url": "https://d1xarpci4ikg0w.cloudfront.net/20635190-872d-41fc-ad79-78ceef343726.webp",
      "type": "animated"
    },
    "priority": 0,
    "tags": ["top_choice"],
    "params": null,
    "categories": ["epic_camera_control", "trending"]
  },
  {
    "id": "017ae2b7-bcff-42ef-863e-6e198f96c3ec",
    "name": "Turning Metal + Melting",
    "media": {
      "width": 320,
      "height": 182,
      "url": "https://d1xarpci4ikg0w.cloudfront.net/9a49c573-c91d-410d-b851-b06f0c06d3b9.webp",
      "type": "animated"
    },
    "priority": 0,
    "tags": ["mix"],
    "params": {
      "motions": [
        {
          "id": "46e23a6b-1047-40f1-9cf5-33f5f55ddf2e",
          "type": "motion",
          "strength": 0.85
        },
        {
          "id": "d8c13031-7117-4a3d-9a30-6a00d0d408b4",
          "type": "motion",
          "strength": 0.6
        }
      ]
    },
    "mix": [
      {
        "id": "46e23a6b-1047-40f1-9cf5-33f5f55ddf2e",
        "name": "Turning Metal",
        "media": {
          "width": 320,
          "height": 424,
          "url": "https://d1xarpci4ikg0w.cloudfront.net/d44a136d-8b78-49c8-bf3d-889e5f30c547.webp",
          "type": "animated"
        }
      },
      {
        "id": "d8c13031-7117-4a3d-9a30-6a00d0d408b4",
        "name": "Melting",
        "media": {
          "width": 320,
          "height": 182,
          "url": "https://d1xarpci4ikg0w.cloudfront.net/208e5e19-956c-48a2-afb7-8ca822c29a23.webp",
          "type": "animated"
        }
      }
    ]
  },
  {
    "id": "6f06f47e-922e-4660-9fe9-754e4be69696",
    "name": "3D Rotation",
    "media": {
      "width": 320,
      "height": 320,
      "url": "https://d1xarpci4ikg0w.cloudfront.net/96ccaa14-59c4-49df-a91d-aa898794b32d.webp",
      "type": "animated"
    },
    "priority": 0,
    "tags": ["new"],
    "params": null,
    "categories": []
  },
  {
    "id": "9ac92661-d0f7-4b5e-85b1-f3654cb4627b",
    "name": "Moonwalk Left",
    "media": {
      "width": 320,
      "height": 424,
      "url": "https://d1xarpci4ikg0w.cloudfront.net/9fdd4463-2e38-4419-a956-aa9645a9343e.webp",
      "type": "animated"
    },
    "priority": 0,
    "tags": [],
    "params": null,
    "categories": ["catch_the_pulse"]
  },
  {
    "id": "b157f3d0-f3d5-4b34-8fd1-ee034c43dd1c",
    "name": "Medusa Gorgona",
    "media": {
      "width": 320,
      "height": 210,
      "url": "https://d1xarpci4ikg0w.cloudfront.net/f671aafc-1e4b-4ab4-916d-0736b3edb8c2.webp",
      "type": "animated"
    },
    "priority": 0,
    "tags": ["new"],
    "params": null,
    "categories": []
  },
  {
    "id": "c99c3417-31d0-47f0-8cc9-1b25dc5de023",
    "name": "Snowboard Powder",
    "media": {
      "width": 320,
      "height": 242,
      "url": "https://d1xarpci4ikg0w.cloudfront.net/b928a301-9609-4948-a045-5a4a79481b5c.webp",
      "type": "animated"
    },
    "priority": 0,
    "tags": [],
    "params": null,
    "categories": ["catch_the_pulse"]
  },
  {
    "id": "9312c53a-f191-4aab-94fb-6b1dbdfdc946",
    "name": "Bullet Time",
    "media": {
      "width": 320,
      "height": 320,
      "url": "https://d1xarpci4ikg0w.cloudfront.net/897e662e-7d15-4ba2-8f2c-dc4c772e347e.webp",
      "type": "animated"
    },
    "priority": 0,
    "tags": ["top_choice"],
    "params": null,
    "categories": ["epic_camera_control", "trending"]
  },
  {
    "id": "c9da59da-aabd-4fd5-a7c8-f09a1d9f9f50",
    "name": "Moonwalk Right",
    "media": {
      "width": 320,
      "height": 210,
      "url": "https://d1xarpci4ikg0w.cloudfront.net/7462c8c3-5c55-43e6-9ad5-42e7e07ddce8.webp",
      "type": "animated"
    },
    "priority": 0,
    "tags": [],
    "params": null,
    "categories": ["catch_the_pulse"]
  },
  {
    "id": "cd5bfd11-5a1a-46e0-9294-b22b0b733b1e",
    "name": "Face Punch",
    "media": {
      "width": 320,
      "height": 242,
      "url": "https://d1xarpci4ikg0w.cloudfront.net/4c75250f-a508-4d36-b092-25cc0837f127.webp",
      "type": "animated"
    },
    "priority": 1,
    "tags": ["top_choice"],
    "params": null,
    "categories": ["vfx", "trending"]
  },
  {
    "id": "b120f292-74e3-4878-817b-626e203f8a92",
    "name": "Incline",
    "media": {
      "width": 320,
      "height": 236,
      "url": "https://d1xarpci4ikg0w.cloudfront.net/bb149d66-0c52-4a7d-afd1-42892f2f6aff.webp",
      "type": "animated"
    },
    "priority": 1,
    "tags": ["new"],
    "params": null,
    "categories": []
  },
  {
    "id": "007f9809-c63e-4f65-9976-3001cf699784",
    "name": "Datamosh",
    "media": {
      "width": 320,
      "height": 236,
      "url": "https://d1xarpci4ikg0w.cloudfront.net/602fb0d0-ee72-4f16-bc26-93feb5283b94.webp",
      "type": "animated"
    },
    "priority": 1,
    "tags": ["new"],
    "params": null,
    "categories": []
  },
  {
    "id": "17a55db6-8775-4a9f-a2c9-d0d373bee590",
    "name": "Boxing",
    "media": {
      "width": 320,
      "height": 210,
      "url": "https://d1xarpci4ikg0w.cloudfront.net/4921b0b7-b524-4365-955a-39949123aaaa.webp",
      "type": "animated"
    },
    "priority": 1,
    "tags": [],
    "params": null,
    "categories": ["catch_the_pulse"]
  },
  {
    "id": "6308a9a6-877d-4fb1-be21-481638833983",
    "name": "Morphskin",
    "media": {
      "width": 320,
      "height": 236,
      "url": "https://d1xarpci4ikg0w.cloudfront.net/01e0631b-8c10-4441-8617-80c638eb29f8.webp",
      "type": "animated"
    },
    "priority": 2,
    "tags": ["new"],
    "params": null,
    "categories": []
  },
  {
    "id": "dbf3fbc1-f69c-4904-a063-104cf2998a40",
    "name": "Head Explosion",
    "media": {
      "width": 320,
      "height": 320,
      "url": "https://d1xarpci4ikg0w.cloudfront.net/63ebed42-5844-4f9f-ae77-a8ce3eefea3d.webp",
      "type": "animated"
    },
    "priority": 2,
    "tags": ["new"],
    "params": null,
    "categories": []
  },
  {
    "id": "ed15397e-0a3d-49e3-add4-b9529698a8ad",
    "name": "Melting",
    "media": {
      "width": 320,
      "height": 486,
      "url": "https://d1xarpci4ikg0w.cloudfront.net/b54b7f22-f4cf-4c9e-928c-fa6a8e6a3a9c.webp",
      "type": "animated"
    },
    "priority": 2,
    "tags": [],
    "params": null,
    "categories": ["vfx", "new"]
  },
  {
    "id": "c2ece0f5-8775-4f8e-924b-b134907b51ad",
    "name": "Baseball Kick",
    "media": {
      "width": 320,
      "height": 240,
      "url": "https://d1xarpci4ikg0w.cloudfront.net/29e0b451-1c9b-4075-85c7-93474a8977cb.webp",
      "type": "animated"
    },
    "priority": 2,
    "tags": [],
    "params": null,
    "categories": ["catch_the_pulse"]
  },
  {
    "id": "0bdbf318-f918-4f9b-829a-74cab681d806",
    "name": "Arc Right",
    "media": {
      "width": 320,
      "height": 424,
      "url": "https://d1xarpci4ikg0w.cloudfront.net/f97e1093-b61a-4bbd-abed-4318fc1249e8.webp",
      "type": "animated"
    },
    "priority": 2,
    "tags": ["top_choice"],
    "params": null,
    "categories": ["epic_camera_control", "trending"]
  },
  {
    "id": "06b50d3a-65a9-432b-bf0b-493fc3dcc006",
    "name": "Set on Fire",
    "media": {
      "width": 320,
      "height": 242,
      "url": "https://d1xarpci4ikg0w.cloudfront.net/a0c9ff96-e3a7-4454-9099-a1f734f50c9e.webp",
      "type": "animated"
    },
    "priority": 2,
    "tags": [],
    "params": null,
    "categories": ["vfx", "new"]
  },
  {
    "id": "e974bca9-c9eb-4cc8-9318-5676cc110f17",
    "name": "Building Explosion",
    "media": {
      "width": 320,
      "height": 182,
      "url": "https://d1xarpci4ikg0w.cloudfront.net/5d4e4106-9149-4761-9973-00cb66253357.webp",
      "type": "animated"
    },
    "priority": 2,
    "tags": ["top_choice"],
    "params": null,
    "categories": ["vfx"]
  },
  {
    "id": "46e23a6b-1047-40f1-9cf5-33f5f55ddf2e",
    "name": "Turning Metal",
    "media": {
      "width": 320,
      "height": 424,
      "url": "https://d1xarpci4ikg0w.cloudfront.net/d44a136d-8b78-49c8-bf3d-889e5f30c547.webp",
      "type": "animated"
    },
    "priority": 3,
    "tags": [],
    "params": null,
    "categories": ["vfx", "new"]
  },
  {
    "id": "4e981984-1cdc-4b96-a2b1-1a7c1ecb822d",
    "name": "Disintegration",
    "media": {
      "width": 320,
      "height": 416,
      "url": "https://d1xarpci4ikg0w.cloudfront.net/634ede39-bc1f-4635-b4bc-eee2d87a4735.webp",
      "type": "animated"
    },
    "priority": 3,
    "tags": [],
    "params": null,
    "categories": ["vfx", "trending"]
  },
  {
    "id": "aab8440c-0d65-4554-b88a-7a9a5e084b6e",
    "name": "Static",
    "media": {
      "width": 320,
      "height": 486,
      "url": "https://d1xarpci4ikg0w.cloudfront.net/b9ee21e0-fa8a-4874-be6d-00f9763a9920.webp",
      "type": "animated"
    },
    "priority": 3,
    "tags": ["top_choice"],
    "params": null,
    "categories": ["basic_camera_control"]
  },
  {
    "id": "86f0a592-515a-4a10-bffe-910c6282cb44",
    "name": "Skateboard Glide",
    "media": {
      "width": 320,
      "height": 242,
      "url": "https://d1xarpci4ikg0w.cloudfront.net/20fb4b13-541c-43c8-ac91-45a0614889a2.webp",
      "type": "animated"
    },
    "priority": 3,
    "tags": [],
    "params": null,
    "categories": ["catch_the_pulse"]
  },
  {
    "id": "6cf1eea1-294a-482b-a43e-98336bfbe381",
    "name": "Symbiote",
    "media": {
      "width": 320,
      "height": 242,
      "url": "https://d1xarpci4ikg0w.cloudfront.net/a6005200-5d6e-42c0-943c-a10e749bbe8a.webp",
      "type": "animated"
    },
    "priority": 3,
    "tags": ["new"],
    "params": null,
    "categories": []
  },
  {
    "id": "c839c180-cf06-4924-8ad5-ddea18c97122",
    "name": "Thunder God + Turning Metal",
    "media": {
      "width": 320,
      "height": 242,
      "url": "https://d1xarpci4ikg0w.cloudfront.net/a90c9740-cf9c-4c7e-acfd-f5b54045a9f1.webp",
      "type": "animated"
    },
    "priority": 4,
    "tags": ["mix"],
    "params": {
      "motions": [
        {
          "id": "ca0568ee-6a0f-4134-a4ee-97dfe44753ba",
          "type": "motion",
          "strength": 0.65
        },
        {
          "id": "46e23a6b-1047-40f1-9cf5-33f5f55ddf2e",
          "type": "motion",
          "strength": 0.8
        }
      ]
    },
    "mix": [
      {
        "id": "ca0568ee-6a0f-4134-a4ee-97dfe44753ba",
        "name": "Thunder God",
        "media": {
          "width": 320,
          "height": 242,
          "url": "https://d1xarpci4ikg0w.cloudfront.net/1abf9bb7-8dfd-42b1-80a8-9ebd48e10487.webp",
          "type": "animated"
        }
      },
      {
        "id": "46e23a6b-1047-40f1-9cf5-33f5f55ddf2e",
        "name": "Turning Metal",
        "media": {
          "width": 320,
          "height": 424,
          "url": "https://d1xarpci4ikg0w.cloudfront.net/d44a136d-8b78-49c8-bf3d-889e5f30c547.webp",
          "type": "animated"
        }
      }
    ]
  },
  {
    "id": "c7b26f66-9d34-44d7-9b18-c8e679e6a391",
    "name": "Ski Carving",
    "media": {
      "width": 320,
      "height": 242,
      "url": "https://d1xarpci4ikg0w.cloudfront.net/1b92b32b-590a-450f-8966-fab196494e33.webp",
      "type": "animated"
    },
    "priority": 4,
    "tags": [],
    "params": null,
    "categories": ["catch_the_pulse"]
  },
  {
    "id": "5eb82f94-2b98-4e4a-ab4b-ee6c872fb2c7",
    "name": "FPV Drone",
    "media": {
      "width": 320,
      "height": 180,
      "url": "https://d1xarpci4ikg0w.cloudfront.net/a6bbb172-ecff-4dcb-87b2-18a87898febd.webp",
      "type": "animated"
    },
    "priority": 5,
    "tags": [],
    "params": null,
    "categories": ["epic_camera_control"]
  },
  {
    "id": "b6eb17bb-d336-46db-99c6-34f01ae754f3",
    "name": "Agent Reveal",
    "media": {
      "width": 320,
      "height": 182,
      "url": "https://d1xarpci4ikg0w.cloudfront.net/4602e616-84b7-4348-a48d-aa255c974329.webp",
      "type": "animated"
    },
    "priority": 5,
    "tags": [],
    "params": null,
    "categories": ["vfx", "new"]
  },
  {
    "id": "a0a7c624-cf2a-4204-a9f8-60623d4a7383",
    "name": "Catwalk",
    "media": {
      "width": 320,
      "height": 242,
      "url": "https://d1xarpci4ikg0w.cloudfront.net/d7df6057-5141-4503-8f77-d784c8c90164.webp",
      "type": "animated"
    },
    "priority": 5,
    "tags": [],
    "params": null,
    "categories": ["catch_the_pulse"]
  }
]

4.生成 ads 任务

post https://api.openai-hk.com/higgsfield/ads

json
curl --request POST \
  --url https://api.openai-hk.com/higgsfield/ads \
  --header 'Authorization: Bearer hk-your-key' \
  --header 'Content-Type: application/json' \
  --data '{
    "product_placement_sample_id": "3hpZ2HB0xS688KnzMIwU16",
    "image":["https://www.openai-hk.com/res/img/open.png" ],
    "size": "1024x1024"
}'
curl --request POST \
  --url https://api.openai-hk.com/higgsfield/ads \
  --header 'Authorization: Bearer hk-your-key' \
  --header 'Content-Type: application/json' \
  --data '{
    "product_placement_sample_id": "3hpZ2HB0xS688KnzMIwU16",
    "image":["https://www.openai-hk.com/res/img/open.png" ],
    "size": "1024x1024"
}'
  • 请求体
json
{
  "product_placement_sample_id": "3hpZ2HB0xS688KnzMIwU16",
  "image": ["https://www.openai-hk.com/res/img/open.png"],
  "size": "1024x1024"
}
{
  "product_placement_sample_id": "3hpZ2HB0xS688KnzMIwU16",
  "image": ["https://www.openai-hk.com/res/img/open.png"],
  "size": "1024x1024"
}

关键字段说明

字段类型说明
imagestring[]参考图片 一般情况下是一张图片,
product_placement_sample_idstring广告动作模版 可以到官网 参考拿到 3hpZ2HB0xS688KnzMIwU16
  • 返回体
  • 得到 id 供给后面查询任务的 task_id 使用第二步骤来查询任务
json
{
  "id": "aca6c73e-aa4c-47bb-aa62-a100a0f7dd22"
}
{
  "id": "aca6c73e-aa4c-47bb-aa62-a100a0f7dd22"
}