API Referansı
Gemini Omni Metinden Videoya
Asenkron bir Görev oluşturmak için metinden videoya uç noktasını kullanın.
01
Genel Bakış
Metinden videoya uç noktasını desteklenen bir modelle kullanın. Durumunu almak için döndürülen Görev Kimliğini kullanın veya aşağıda belgelenen teslimler için callback_url sağlayın.
Hızlı başlangıç
- Bir API anahtarı oluşturun ve RUNAPI_API_KEY olarak ayarlayın.
- Desteklenen bir model seçin ve gövdesi o modelin şemasıyla eşleşen bir POST isteği gönderin.
- Döndürülen görev kimliğini saklayın, ardından bir terminal durumuna ulaşana kadar yoklama yapın ya da aşağıda belgelenen geri çağırmaları işleyin.
Uç Nokta
- Temel URL
https://runapi.ai- API sürümü
v1- Kimlik doğrulama
Authorization: Bearer YOUR_API_TOKEN
02
Desteklenen modeller
Güncel fiyatlandırma, hız sınırları ve ticari kullanım ayrıntıları için bir model sayfası açın.
03
JSON gövdesiİstek şeması
Alanlar ve izin verilen değerler seçili modele göre değişir. Sağlandığında, callback_url aşağıda belgelenen Görev teslimatlarını alır.
gemini-omni-flash-1-116 alan
aspect_ratiostring
İsteğe bağlı
Çıktı en boy oranı.
İzin verilen değerler:16:9, 9:16
audio_idsarray
İsteğe bağlı
create-audio tarafından döndürülen ses ön ayarı kimlikleri.
Öğe sınırı:3
callback_urlstring
İsteğe bağlı
Terminal Görev teslimi için webhook URL'si.
character_idsarray
İsteğe bağlı
create-character tarafından döndürülen karakter kimlikleri; çift görüntülü karakterler, paylaşılan yedi referans biriminden ikisini tüketir.
Öğe sınırı:3
duration_secondsinteger
Zorunlu
Saniye cinsinden çıktı süresi.
İzin verilen değerler:4, 6, 8, 10
first_frame_image_urlstring
İsteğe bağlı
Herkese açık ilk kare görüntüsü URL'si; referans görüntüler, ses kimlikleri, video klipleri ve karakter kimlikleriyle karşılıklı olarak birbirini dışlar.
last_frame_image_urlstring
İsteğe bağlı
Genel son kare görsel URL'si; first_frame_image_url gerektirir.
modelstring
İsteğe bağlı
Model tanımlayıcısı; belirtilmediğinde varsayılan olarak gemini-omni-text-to-video kullanılır.
output_resolutionstring
İsteğe bağlı
Çıktı çözünürlüğü.
İzin verilen değerler:360p, 720p, 1080p, 4k
Varsayılan: 720p
promptstring
Zorunlu
Video oluşturma istemi.
Sınır:20000
reference_image_urlsarray
İsteğe bağlı
Genel referans görsel URL'leri; görseller, video klipleri ve karakterler yedi birimlik referans sınıfını paylaşır.
Öğe sınırı:7
seedinteger
İsteğe bağlı
Deterministik üretim tohumu.
Aralık:0 - 2147483647
video_listarray
İsteğe bağlı
Kaynak video klipleri; her klip iki referans birimi tüketir.
Öğe sınırı:1
video_list[].endsnumber
Zorunlu
Klip bitiş süresi saniye cinsinden; başlangıçtan büyük ve başlangıçtan en fazla 10 saniye sonra olmalıdır.
Sınır:0
video_list[].startnumber
Zorunlu
Klip başlangıç süresi saniye cinsinden.
Sınır:0
video_list[].urlstring
Zorunlu
Genel kaynak video URL'si.
gemini-omni-flash-preview5 alan
aspect_ratiostring
İsteğe bağlı
Çıktı en boy oranı.
İzin verilen değerler:16:9, 9:16
Varsayılan: 16:9
callback_urlstring
İsteğe bağlı
Terminal Görev teslimi için webhook URL'si.
modelstring
İsteğe bağlı
Model tanımlayıcısı; belirtilmediğinde varsayılan olarak gemini-omni-text-to-video kullanılır.
output_resolutionstring
İsteğe bağlı
Çıktı çözünürlüğü.
İzin verilen değerler:720p
Varsayılan: 720p
promptstring
Zorunlu
Video oluşturma istemi.
Sınır:20000
gemini-omni-text-to-video14 alan
aspect_ratiostring
İsteğe bağlı
Çıktı en boy oranı.
İzin verilen değerler:16:9, 9:16
audio_idsarray
İsteğe bağlı
create-audio tarafından döndürülen ses ön ayarı kimlikleri.
Öğe sınırı:3
callback_urlstring
İsteğe bağlı
Terminal Görev teslimi için webhook URL'si.
character_idsarray
İsteğe bağlı
create-character tarafından döndürülen karakter kimlikleri; çift görüntülü karakterler, paylaşılan yedi referans biriminden ikisini tüketir.
Öğe sınırı:3
duration_secondsinteger
Zorunlu
Saniye cinsinden çıktı süresi.
İzin verilen değerler:4, 6, 8, 10
modelstring
İsteğe bağlı
Model tanımlayıcısı; belirtilmediğinde varsayılan olarak gemini-omni-text-to-video kullanılır.
Varsayılan:gemini-omni-text-to-video
output_resolutionstring
İsteğe bağlı
Çıktı çözünürlüğü.
İzin verilen değerler:720p, 1080p, 4k
Varsayılan: 720p
promptstring
Zorunlu
Video oluşturma istemi.
Sınır:20000
reference_image_urlsarray
İsteğe bağlı
Genel referans görsel URL'leri; görseller, video klipleri ve karakterler yedi birimlik referans sınıfını paylaşır.
Öğe sınırı:7
seedinteger
İsteğe bağlı
Deterministik üretim tohumu.
Aralık:0 - 2147483647
video_listarray
İsteğe bağlı
Kaynak video klipleri; her klip iki referans birimi tüketir.
Öğe sınırı:1
video_list[].endsnumber
Zorunlu
Klip bitiş süresi saniye cinsinden; başlangıçtan büyük ve başlangıçtan en fazla 10 saniye sonra olmalıdır.
Sınır:0
video_list[].startnumber
Zorunlu
Klip başlangıç süresi saniye cinsinden.
Sınır:0
video_list[].urlstring
Zorunlu
Genel kaynak video URL'si.
Koşullu kurallar
Bu gereksinimler, listelenen tüm koşulların eşleştiği durumlarda uygulanır.
-
Şu durumlarda
first_frame_image_url = {"present" => true},model = gemini-omni-flash-1-1- Gerekli
- Kabul edilmez
reference_image_urls,audio_ids,video_list,character_ids
-
Şu durumlarda
last_frame_image_url = {"present" => true},model = gemini-omni-flash-1-1- Gerekli
first_frame_image_url- Kabul edilmez
-
Şu durumlarda
model = gemini-omni-flash-preview- Gerekli
- Kabul edilmez
reference_image_urls,audio_ids,video_list,character_ids,first_frame_image_url,last_frame_image_url,duration_seconds,seed
-
Şu durumlarda
model = gemini-omni-text-to-video- Gerekli
- Kabul edilmez
first_frame_image_url,last_frame_image_url
04
HTTP 202Kabul oluştur
POST /api/v1/gemini_omni/text_to_video
Yanıt şeması
JSON
{
"properties": {
"billing": {
"properties": {
"refund": {
"oneOf": [
{
"properties": {
"refunded_at": {
"type": "string"
}
},
"required": [
"refunded_at"
],
"type": "object",
"unevaluatedProperties": false
},
{
"enum": [
null
]
}
]
},
"reservation": {
"oneOf": [
{
"properties": {
"amount_cents": {
"type": "integer"
}
},
"required": [
"amount_cents"
],
"type": "object",
"unevaluatedProperties": false
},
{
"enum": [
null
]
}
]
},
"settlement": {
"oneOf": [
{
"properties": {
"amount_micro_cents": {
"type": "integer"
},
"charged_amount_cents": {
"type": "integer"
}
},
"required": [
"charged_amount_cents",
"amount_micro_cents"
],
"type": "object",
"unevaluatedProperties": false
},
{
"enum": [
null
]
}
]
}
},
"required": [
"reservation",
"settlement",
"refund"
],
"type": "object",
"unevaluatedProperties": false
},
"id": {
"type": "string"
},
"status": {
"enum": [
"processing"
],
"type": "string"
},
"task_replayed": {
"type": "boolean"
}
},
"required": [
"id",
"status",
"billing"
],
"type": "object",
"unevaluatedProperties": false
}Yanıt örneği
JSON
{
"billing": {
"refund": null,
"reservation": null,
"settlement": null
},
"id": "tsk_reference_demo",
"status": "processing"
}05
HTTP 200Yoklama işleniyor
GET /api/v1/gemini_omni/text_to_video/:id
Yanıt şeması
JSON
{
"properties": {
"billing": {
"properties": {
"refund": {
"oneOf": [
{
"properties": {
"refunded_at": {
"type": "string"
}
},
"required": [
"refunded_at"
],
"type": "object",
"unevaluatedProperties": false
},
{
"enum": [
null
]
}
]
},
"reservation": {
"oneOf": [
{
"properties": {
"amount_cents": {
"type": "integer"
}
},
"required": [
"amount_cents"
],
"type": "object",
"unevaluatedProperties": false
},
{
"enum": [
null
]
}
]
},
"settlement": {
"oneOf": [
{
"properties": {
"amount_micro_cents": {
"type": "integer"
},
"charged_amount_cents": {
"type": "integer"
}
},
"required": [
"charged_amount_cents",
"amount_micro_cents"
],
"type": "object",
"unevaluatedProperties": false
},
{
"enum": [
null
]
}
]
}
},
"required": [
"reservation",
"settlement",
"refund"
],
"type": "object",
"unevaluatedProperties": false
},
"id": {
"type": "string"
},
"status": {
"enum": [
"processing"
],
"type": "string"
}
},
"required": [
"id",
"status",
"billing"
],
"type": "object",
"unevaluatedProperties": false
}Yanıt örneği
JSON
{
"billing": {
"refund": null,
"reservation": null,
"settlement": null
},
"id": "tsk_reference_demo",
"status": "processing"
}06
HTTP 200Yoklama tamamlandı
GET /api/v1/gemini_omni/text_to_video/:id
Yanıt şeması
JSON
{
"properties": {
"billing": {
"properties": {
"refund": {
"oneOf": [
{
"properties": {
"refunded_at": {
"type": "string"
}
},
"required": [
"refunded_at"
],
"type": "object",
"unevaluatedProperties": false
},
{
"enum": [
null
]
}
]
},
"reservation": {
"oneOf": [
{
"properties": {
"amount_cents": {
"type": "integer"
}
},
"required": [
"amount_cents"
],
"type": "object",
"unevaluatedProperties": false
},
{
"enum": [
null
]
}
]
},
"settlement": {
"oneOf": [
{
"properties": {
"amount_micro_cents": {
"type": "integer"
},
"charged_amount_cents": {
"type": "integer"
}
},
"required": [
"charged_amount_cents",
"amount_micro_cents"
],
"type": "object",
"unevaluatedProperties": false
},
{
"enum": [
null
]
}
]
}
},
"required": [
"reservation",
"settlement",
"refund"
],
"type": "object",
"unevaluatedProperties": false
},
"id": {
"type": "string"
},
"status": {
"enum": [
"completed"
],
"type": "string"
},
"videos": {
"items": {
"properties": {
"url": {
"type": "string",
"x-runapi-generated-media": true
}
},
"required": [
"url"
],
"type": "object",
"unevaluatedProperties": false
},
"type": "array"
}
},
"required": [
"id",
"status",
"videos",
"billing"
],
"type": "object",
"unevaluatedProperties": false
}Yanıt örneği
JSON
{
"billing": {
"refund": null,
"reservation": null,
"settlement": null
},
"id": "tsk_reference_demo",
"status": "completed",
"videos": [
{
"url": "https://file.runapi.ai/reference-video.mp4"
}
]
}07
HTTP 200Yoklama başarısız oldu
GET /api/v1/gemini_omni/text_to_video/:id
Yanıt şeması
JSON
{
"properties": {
"billing": {
"properties": {
"refund": {
"oneOf": [
{
"properties": {
"refunded_at": {
"type": "string"
}
},
"required": [
"refunded_at"
],
"type": "object",
"unevaluatedProperties": false
},
{
"enum": [
null
]
}
]
},
"reservation": {
"oneOf": [
{
"properties": {
"amount_cents": {
"type": "integer"
}
},
"required": [
"amount_cents"
],
"type": "object",
"unevaluatedProperties": false
},
{
"enum": [
null
]
}
]
},
"settlement": {
"oneOf": [
{
"properties": {
"amount_micro_cents": {
"type": "integer"
},
"charged_amount_cents": {
"type": "integer"
}
},
"required": [
"charged_amount_cents",
"amount_micro_cents"
],
"type": "object",
"unevaluatedProperties": false
},
{
"enum": [
null
]
}
]
}
},
"required": [
"reservation",
"settlement",
"refund"
],
"type": "object",
"unevaluatedProperties": false
},
"error": {
"type": "string"
},
"id": {
"type": "string"
},
"status": {
"enum": [
"failed"
],
"type": "string"
}
},
"required": [
"id",
"status",
"error",
"billing"
],
"type": "object",
"unevaluatedProperties": false
}Yanıt örneği
JSON
{
"billing": {
"refund": null,
"reservation": null,
"settlement": null
},
"error": "Task processing failed.",
"id": "tsk_reference_demo",
"status": "failed"
}08
HTTP 200Müşteri geri çağırması: tamamlandı
POST callback_url
Yanıt şeması
JSON
{
"properties": {
"id": {
"type": "string"
},
"status": {
"enum": [
"completed"
],
"type": "string"
},
"videos": {
"items": {
"properties": {
"url": {
"type": "string",
"x-runapi-generated-media": true
}
},
"required": [
"url"
],
"type": "object",
"unevaluatedProperties": false
},
"type": "array"
}
},
"required": [
"id",
"status",
"videos"
],
"type": "object",
"unevaluatedProperties": false
}Yanıt örneği
JSON
{
"id": "tsk_reference_demo",
"status": "completed",
"videos": [
{
"url": "https://file.runapi.ai/reference-video.mp4"
}
]
}09
HTTP 200Müşteri geri çağırması: başarısız oldu
POST callback_url
Yanıt şeması
JSON
{
"properties": {
"error": {
"oneOf": [
{
"type": "string"
},
{
"properties": {
"code": {
"type": "string"
},
"limit_cents": {
"type": "integer"
},
"message": {
"type": "string"
},
"reset_at": {
"format": "date-time",
"type": [
"string",
"null"
]
},
"used_cents": {
"type": "integer"
},
"window": {
"enum": [
"1h",
"1d",
"7d",
"daily",
"weekly",
"monthly",
"lifetime"
],
"type": "string"
}
},
"required": [
"code",
"message"
],
"type": "object",
"unevaluatedProperties": false
}
]
},
"id": {
"type": "string"
},
"status": {
"enum": [
"failed"
],
"type": "string"
}
},
"required": [
"id",
"status",
"error"
],
"type": "object",
"unevaluatedProperties": false
}Yanıt örneği
JSON
{
"error": {
"code": "generation_failed",
"message": "Task processing failed."
},
"id": "tsk_reference_demo",
"status": "failed"
}10
HTTP 401Hatalar
POST /api/v1/gemini_omni/text_to_video
Yanıt şeması
JSON
{
"properties": {
"error": {
"description": "İnsan tarafından okunabilir hata mesajı.",
"type": "string"
}
},
"required": [
"error"
],
"type": "object",
"unevaluatedProperties": false
}Yanıt örneği
JSON
{
"error": "Authentication required"
}11
HTTP 401Hatalar
GET /api/v1/gemini_omni/text_to_video/:id
Yanıt şeması
JSON
{
"properties": {
"error": {
"description": "İnsan tarafından okunabilir hata mesajı.",
"type": "string"
}
},
"required": [
"error"
],
"type": "object",
"unevaluatedProperties": false
}Yanıt örneği
JSON
{
"error": "Authentication required"
}12
HTTP 400Hatalar
POST /api/v1/gemini_omni/text_to_video
Yanıt şeması
JSON
{
"oneOf": [
{
"properties": {
"error": {
"description": "İnsan tarafından okunabilir hata mesajı.",
"type": "string"
}
},
"required": [
"error"
],
"type": "object",
"unevaluatedProperties": false
},
{
"properties": {
"error": {
"description": "İnsan tarafından okunabilir doğrulama özeti.",
"type": "string"
},
"errors": {
"additionalProperties": {
"items": {
"type": "string"
},
"type": "array"
},
"description": "Herkese açık istek alanına göre anahtarlanan doğrulama mesajları; her alan için insan tarafından okunabilir dizelerden oluşan bir dizi içerir.",
"type": "object"
}
},
"required": [
"error",
"errors"
],
"type": "object",
"unevaluatedProperties": false
}
]
}Yanıt örneği
JSON
{
"error": "model must be one of: gemini-omni-flash-1-1, gemini-omni-flash-preview, gemini-omni-text-to-video"
}13
HTTP 402Hatalar
POST /api/v1/gemini_omni/text_to_video
Yanıt şeması
JSON
{
"properties": {
"error": {
"description": "İnsan tarafından okunabilir hata mesajı.",
"type": "string"
}
},
"required": [
"error"
],
"type": "object",
"unevaluatedProperties": false
}Yanıt örneği
JSON
{
"error": "Insufficient balance"
}14
HTTP 429Hatalar
POST /api/v1/gemini_omni/text_to_video
Yanıt şeması
JSON
{
"properties": {
"error": {
"description": "İnsan tarafından okunabilir hata mesajı.",
"type": "string"
}
},
"required": [
"error"
],
"type": "object",
"unevaluatedProperties": false
}Yanıt örneği
JSON
{
"error": "API key credit limit exceeded"
}15
HTTP 409Hatalar
POST /api/v1/gemini_omni/text_to_video
Yanıt şeması
JSON
{
"properties": {
"error": {
"description": "İnsan tarafından okunabilir hata mesajı.",
"type": "string"
}
},
"required": [
"error"
],
"type": "object",
"unevaluatedProperties": false
}Yanıt örneği
JSON
{
"error": "The request uses features that are not supported for the selected model"
}16
HTTP 429Hatalar
POST /api/v1/gemini_omni/text_to_video
Yanıt şeması
JSON
{
"properties": {
"error": {
"description": "İnsan tarafından okunabilir hata mesajı.",
"type": "string"
}
},
"required": [
"error"
],
"type": "object",
"unevaluatedProperties": false
}Yanıt örneği
JSON
{
"error": "Rate limit reached. Please retry later."
}17
HTTP 503Hatalar
POST /api/v1/gemini_omni/text_to_video
Yanıt şeması
JSON
{
"properties": {
"error": {
"description": "İnsan tarafından okunabilir hata mesajı.",
"type": "string"
}
},
"required": [
"error"
],
"type": "object",
"unevaluatedProperties": false
}Yanıt örneği
JSON
{
"error": "Service under maintenance, please try again later"
}18
HTTP 504Hatalar
POST /api/v1/gemini_omni/text_to_video
Yanıt şeması
JSON
{
"properties": {
"error": {
"description": "İnsan tarafından okunabilir hata mesajı.",
"type": "string"
}
},
"required": [
"error"
],
"type": "object",
"unevaluatedProperties": false
}Yanıt örneği
JSON
{
"error": "The request timed out"
}19
HTTP 404Hatalar
GET /api/v1/gemini_omni/text_to_video/:id
Yanıt şeması
JSON
{
"properties": {
"error": {
"description": "İnsan tarafından okunabilir hata mesajı.",
"type": "string"
}
},
"required": [
"error"
],
"type": "object",
"unevaluatedProperties": false
}Yanıt örneği
JSON
{
"error": "Task with id 'tsk_reference_demo' not found"
}20
Oluşturulan Kod Örnekleri
Doğrudan cURL kullanın veya diliniz için bir SDK yükleyin. Her örnek, bu başvuruda gösterilen doğrulanmış isteği gönderir.
Yükle
Shell
pip install runapi-gemini-omni
PYTHON
import os
from runapi.gemini_omni import GeminiOmniClient
client = GeminiOmniClient(api_key=os.environ["RUNAPI_API_KEY"])
task = client.text_to_video.create(
model="gemini-omni-text-to-video",
prompt="A presenter walks through a bright studio.",
duration_seconds=4
)