Create a generation

POST

generations

Create a generation

curl --request POST \
  --url https://havincy.com/api/v1/generations \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "modality": "<string>",
  "model_id": "<string>",
  "prompt": "<string>",
  "track": "<string>",
  "count": 123,
  "aspect_ratio": "<string>",
  "resolution": "<string>",
  "duration": 123,
  "generate_audio": true,
  "voice": "<string>",
  "language": "<string>",
  "reference_asset_ids": [
    123
  ],
  "reference_image_urls": [
    "<string>"
  ],
  "wait_seconds": 123
}
'

const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    modality: '<string>',
    model_id: '<string>',
    prompt: '<string>',
    track: '<string>',
    count: 123,
    aspect_ratio: '<string>',
    resolution: '<string>',
    duration: 123,
    generate_audio: true,
    voice: '<string>',
    language: '<string>',
    reference_asset_ids: [123],
    reference_image_urls: ['<string>'],
    wait_seconds: 123
  })
};

fetch('https://havincy.com/api/v1/generations', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

import requests

url = "https://havincy.com/api/v1/generations"

payload = {
    "modality": "<string>",
    "model_id": "<string>",
    "prompt": "<string>",
    "track": "<string>",
    "count": 123,
    "aspect_ratio": "<string>",
    "resolution": "<string>",
    "duration": 123,
    "generate_audio": True,
    "voice": "<string>",
    "language": "<string>",
    "reference_asset_ids": [123],
    "reference_image_urls": ["<string>"],
    "wait_seconds": 123
}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

{
  "object": "generation",
  "status": "queued",
  "credits_charged": 48,
  "covered_by_monthly_gift": false,
  "credits_balance": 2432,
  "assets": [
    {
      "id": 5678,
      "object": "asset",
      "kind": "image",
      "modality": "image",
      "status": "queued",
      "model": "fal-nano-banana-2",
      "prompt": "A cat astronaut floating above Paris, watercolor",
      "credits": 12,
      "settings": { "aspect_ratio": "1:1", "resolution": "1k" },
      "origin": "rest",
      "app_url": "https://havincy.com/ressources/5678",
      "created_at": "2026-10-05T10:12:00+02:00"
    }
  ]
}

Generates images, videos, voice-overs, music or 3D models and charges credits. Pick a model_id from List models. Generation is asynchronous: the response contains the created assets with status queued or processing. Set wait_seconds (max 55) to wait for the result, or poll Get a generation. Required permission: generate. MCP tool: generate.

string

required

image, video, audio or 3d.

string

required

Model id from List models. Must belong to the modality (and track).

string

required

What to create (max 5000 characters). For voice: the exact text to speak.

string

Audio only: voice (default) or music.

integer

default:"1"

Number of outputs, images only (1 to 4). Each output is charged.

string

Image or video aspect ratio, e.g. 1:1, 9:16, 16:9.

string

Image resolution (e.g. 1k, 2k) or video resolution (e.g. 720p, 1080p).

integer

Video duration in seconds (see options.durations_seconds).

boolean

Video: generate native sound when the model supports it.

string

Voice id for text to speech (see options.voices).

string

Voice language code, e.g. fr, en.

integer[]

Library image ids used as references (max 4).

string[]

Public https image URLs or data: URIs used as references (max 4, JPEG/PNG/WEBP, 10 MB).

integer

default:"0"

Wait up to N seconds (0 to 55) for completion before responding.

{
  "object": "generation",
  "status": "queued",
  "credits_charged": 48,
  "covered_by_monthly_gift": false,
  "credits_balance": 2432,
  "assets": [
    {
      "id": 5678,
      "object": "asset",
      "kind": "image",
      "modality": "image",
      "status": "queued",
      "model": "fal-nano-banana-2",
      "prompt": "A cat astronaut floating above Paris, watercolor",
      "credits": 12,
      "settings": { "aspect_ratio": "1:1", "resolution": "1k" },
      "origin": "rest",
      "app_url": "https://havincy.com/ressources/5678",
      "created_at": "2026-10-05T10:12:00+02:00"
    }
  ]
}

⌘I

Create a generation

curl --request POST \
  --url https://havincy.com/api/v1/generations \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "modality": "<string>",
  "model_id": "<string>",
  "prompt": "<string>",
  "track": "<string>",
  "count": 123,
  "aspect_ratio": "<string>",
  "resolution": "<string>",
  "duration": 123,
  "generate_audio": true,
  "voice": "<string>",
  "language": "<string>",
  "reference_asset_ids": [
    123
  ],
  "reference_image_urls": [
    "<string>"
  ],
  "wait_seconds": 123
}
'

const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    modality: '<string>',
    model_id: '<string>',
    prompt: '<string>',
    track: '<string>',
    count: 123,
    aspect_ratio: '<string>',
    resolution: '<string>',
    duration: 123,
    generate_audio: true,
    voice: '<string>',
    language: '<string>',
    reference_asset_ids: [123],
    reference_image_urls: ['<string>'],
    wait_seconds: 123
  })
};

fetch('https://havincy.com/api/v1/generations', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

import requests

url = "https://havincy.com/api/v1/generations"

payload = {
    "modality": "<string>",
    "model_id": "<string>",
    "prompt": "<string>",
    "track": "<string>",
    "count": 123,
    "aspect_ratio": "<string>",
    "resolution": "<string>",
    "duration": 123,
    "generate_audio": True,
    "voice": "<string>",
    "language": "<string>",
    "reference_asset_ids": [123],
    "reference_image_urls": ["<string>"],
    "wait_seconds": 123
}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

{
  "object": "generation",
  "status": "queued",
  "credits_charged": 48,
  "covered_by_monthly_gift": false,
  "credits_balance": 2432,
  "assets": [
    {
      "id": 5678,
      "object": "asset",
      "kind": "image",
      "modality": "image",
      "status": "queued",
      "model": "fal-nano-banana-2",
      "prompt": "A cat astronaut floating above Paris, watercolor",
      "credits": 12,
      "settings": { "aspect_ratio": "1:1", "resolution": "1k" },
      "origin": "rest",
      "app_url": "https://havincy.com/ressources/5678",
      "created_at": "2026-10-05T10:12:00+02:00"
    }
  ]
}

Overview

Account & models

Generation

Encore effects

Library & brand

Social publishing

Create a generation