Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.unifically.com/llms.txt

Use this file to discover all available pages before exploring further.

Generate short text-to-video and reference-to-video clips with Google’s Gemini Omni Flash video model.

​
Model

google/omni-flash-video

​
Parameters

ParameterTypeRequiredDefaultDescription
promptstringYes-Main video prompt. Use @ImageN or @CharacterN to point at specific references. Unknown references are left as plain text.
seedintegerNoRandomSeed sent to Omni Flash. If omitted, a seed is generated automatically and returned when available.
aspect_ratiostringNo"16:9"Output orientation. Allowed: "16:9", "9:16".
durationintegerNo4Clip length in seconds. Allowed: 4, 6, 8, 10.
reference_image_urlsstring[]No-Publicly reachable image reference URLs. Max 7 total expanded image + character image URLs.
reference_charactersarrayNo-Character references. Max 3 character items; expanded character image URLs count toward the total 7 reference limit.
voicestringNo-Request-level Google Flow voice preset ID. Requires at least one image or character reference. See available voices.
Start/end frame fields are not enabled for Omni Flash video generation. Use Veo 3.1 for first-frame or first-and-last-frame workflows.

​
Character References

Each character must be an object with image_urls. Even one-image characters must use an array. 
{
  "image_urls": [
    "https://example.com/character-front.png",
    "https://example.com/character-profile.png"
  ],
  "name": "Ada",
  "description": "warm, sharp, curious"
}
FieldTypeRequiredDescription
image_urlsstring[]Yes*Publicly reachable character image URLs. Use 1-10 images for a character entity.
namestringNoDisplay name for the character.
descriptionstringNoCharacter notes/personality text.
*image_urls must contain at least one URL.

​
Example

curl -X POST https://api.unifically.com/v1/tasks \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -d '{
    "model": "google/omni-flash-video",
    "input": {
      "prompt": "Make @Character1 and @Image1 dance in a neon studio with energetic camera movement.",
      "reference_image_urls": [
        "https://example.com/neon-studio.png"
      ],
      "reference_characters": [
        {
          "image_urls": [
            "https://example.com/dancer.png"
          ],
          "name": "Dancer"
        }
      ],
      "duration": 10,
      "aspect_ratio": "9:16"
    }
  }'

​
Prompt References

TokenRefers to
@Image1, @Image2Items from reference_image_urls only
@Character1, @Character2Items from reference_characters only. With multiple image_urls, the token points to the character item; extra images are identity references

​
Rejected Combinations

InputWhy rejected
start_image_url or end_image_urlStart/end frames are not enabled for Omni Flash generation yet.
More than 7 total expanded image URLsOmni Flash generation reference limit.
More than 3 character itemsCharacter item limit.
image_url on a characterUse image_urls instead, even for one image.
Plain string character entriesCharacter entries must be objects with image_urls.
Empty image_urlsA character needs at least one image.
More than 10 image_urls on one characterCharacter entity image limit.

​
Response

{
  "code": 200,
  "success": true,
  "data": {
    "task_id": "abc123def456",
    "status": "pending"
  }
}