Higgsfield (API)

Prerequisites

The following packages need to be installed before proceeding:

• docker/docker-compose
• golang-migrate

How to run

• Run the "entrypoint.sh" script:

  chmod +x entrypoint.sh
  ./entrypoint.sh

Services/Endpoints

Image-to-Video:

• POST /image2video - Send request to generate video:

  • Request:
    • Body:

    {
      "model": "veo-3-fast",        // "veo-3" or "veo-3-fast"
      "quality": "basic",           // "basic" or "high"
      "aspect_ratio": "16:9",       // "16:9" or "9:16"
      "seed": 1,                    // from 1 to 1 000 000
      "enhance_prompt": true,       // true or false
      "prompt": "i need you to create an animated video presentation based on the attached picture. the video has to look like one of these fancy company ads/trailers where text panels are zoomed in and out",
      "audio_prompt": "add background music like in corporate ads. also add a male narrator voice that summarizes info",
      "image_url": [
        "https://d3snorpfx4xhv8.cloudfront.net/5dc53534-b608-4345-8f2c-1c2d316176d5/276ddcf3-1dcf-4583-9643-4b735eb2500d.jpeg"
      ]
    }

  • Response (200 OK):

  {
      "id": "2b66d261-8b29-44db-9323-46180e8b051c",
      "type": "veo3_speak",
      "created_at": "2025-10-18T19:06:00.782639Z",
      "jobs": [
          {
              "id": "c2163a5d-afbb-408e-9d61-1c7ee172572b",
              "job_set_type": "veo3_speak",
              "status": "queued",
              "results": null
          }
      ],
      "input_params": {
          "prompt": "i need you to create an animated video presentation based on the attached picture. the video has to look like one of these fancy company ads/trailers where text panels are zoomed in and out",
          "input_images": null,
          "aspect_ratio": "16:9"
      }
  }

Results:

• GET /results/{job_id} - Get status and result of a request:

  • Request: None
  • Response (200 OK):

  {
      "id": "1d88798c-5455-45d0-b728-d6aad034b323",
      "type": "veo3_speak",
      "created_at": "2025-10-18T21:08:54.432296Z",
      "jobs": [
          {
              "id": "53606207-8b0f-4291-8f7c-6daf93e0e140",
              "job_set_type": "veo3_speak",
              "status": "completed",
              "results": {
                  "raw": {
                      "url": "https://d3u0tzju9qaucj.cloudfront.net/5dc53534-b608-4345-8f2c-1c2d316176d5/86344a74-ddd1-485e-8c49-bcb5c73222f3.mp4",
                      "type": "video"
                  }
              }
          }
      ],
      "input_params": {
          "aspect_ratio": "16:9",
          "audio_prompt": "add background music like in corporate ads. also add a male narrator voice that summarizes info",
          "background_prompt": null,
          "enhance_prompt": true,
          "input_image": {
              "image_url": "https://d3snorpfx4xhv8.cloudfront.net/5dc53534-b608-4345-8f2c-1c2d316176d5/276ddcf3-1dcf-4583-9643-4b735eb2500d.jpeg",
              "type": "image_url"
          },
          "model": "veo-3-fast",
          "motion_id": null,
          "prompt": "i need you to create an animated video presentation based on the attached picture. the video has to look like one of these fancy company ads/trailers where text panels are zoomed in and out",
          "quality": "basic",
          "seed": 724889
      }
  }