Register a reusable character from a portrait and optional body image. This synchronous request returns the character ID in data.id. Save that ID and pass the exact same value in input.character_ids when calling Gemini Omni Flash 1.1 Reference to Video.
Developer API pricing
Provider: SeeAPI
USD estimate: $0.0037 / credit · Estimated equivalent, not an additional charge.
Price: 0 credits/gen (≈ $0.00/gen)
/v1/generationsA stable key for each resource creation request. Reuse it only when retrying the identical request.
create-character-001The model ID shown in the selected model's API documentation.
gemini-omni-charactergemini-omni-charactergemini-omni-characterCreate Character. Use the Endpoint ID shown in this model's API documentation.
create-charactercreate-charactercreate-characterOptional public Provider ID. Omit it to use the Endpoint default Provider (seeapi).
seeapiseeapiseeapiCreation parameters for the selected resource endpoint and public Provider.
Provider parameters
seeapiDefault ProviderDescribe the character’s appearance, personality, and background.
female. Nyra is an adult explorer with silver hair and a teal jacket.Public HTTPS image URLs: the first image is the portrait; the optional second image is the body reference.
["https://client.example.com/nyra-portrait.png","https://client.example.com/nyra-body.png"]Display name for the character. If omitted, the resource is named Character.
NyraOptional registered voice ID returned by Create Audio. Preserve the returned ID unchanged; omit this field or use an empty array when no voice is bound.
["aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa"]The created resource. The same request and Idempotency-Key return the saved resource directly.
The character ID returned by this creation request. Save it and pass the exact returned value as an item in input.character_ids when generating a video with Gemini Omni Flash 1.1 / reference-to-video.
Resource type.
characterResource name.
Portrait URL for a character; null when no preview is available.
Saved public creation details.
Gender extracted from the character description, when present.
The character background description.
The optional body image URL.
Names of associated audio resources.
Invalid JSON, parameters, Schema, or API Policy
Invalid API Key or authentication failed
The current request is not allowed
Model, Endpoint, or referenced resource not found
Idempotency conflict, or creation could not be confirmed. Retry the identical request with the same key; do not create a duplicate.
Request body is too large
Too many requests
Service temporarily unavailable
const response = await fetch("https://api.seeapi.com/v1/generations", {
method: "POST",
headers: {
"Authorization": "Bearer YOUR_API_KEY",
"Idempotency-Key": "create-character-001",
"Content-Type": "application/json"
},
body: JSON.stringify({
"model": "gemini-omni-character",
"endpoint": "create-character",
"provider": "seeapi",
"input": {
"descriptions": "female. Nyra is an adult explorer with silver hair and a teal jacket.",
"image_urls": [
"https://client.example.com/nyra-portrait.png",
"https://client.example.com/nyra-body.png"
],
"character_name": "Nyra",
"audio_ids": [
"aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa"
]
}
})
});
const result = await response.json();{
"data": {
"id": "bbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbb",
"type": "character",
"name": "Nyra",
"preview_url": "https://client.example.com/nyra-portrait.png",
"details": {
"gender": "female",
"background": "Nyra is an adult explorer with silver hair and a teal jacket.",
"linked_audio_names": []
}
}
}