Seedance istem iyileştirme API’si

APIMaster’ın bağımsız metin hizmetidir; video görevi oluşturmaz. Volcengine’in açık kılavuzuna dayanır; resmi Seedance API’si değildir ve resmi Skill’i dağıtmaz.

POST https://apimaster.ai/v1/video/prompt-optimize

APIMaster API Key kullanın. model, kullanılabilir rotası ve Key izni olan ücretli metin modelini seçer. target_model video modelidir; yalnızca seedance-2.5 desteklenir. Örnekteki metin modeli kullanılamıyorsa değiştirin.

Hızlı başlangıç

curl --fail-with-body -sS "https://apimaster.ai/v1/video/prompt-optimize" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "model": "gemini-3.1-flash-lite",
  "target_model": "seedance-2.5",
  "prompt": "A cat watches raindrops on a window, then turns toward the camera.",
  "language": "tr",
  "task": "generate",
  "duration": 5
}'

Parametreler

JSON
model	Zorunlu: iyileştirme için ücretli metin modeli kimliği.
prompt	Zorunlu: 1–12000 karakter. Referans etiketlerini ve replikleri koruyun.
target_model	İsteğe bağlı: varsayılan ve tek desteklenen değer seedance-2.5.
language	İsteğe bağlı: tr veya en gibi çıktı dili; atlanırsa girdi dili. En fazla 64 bayt.
task	İsteğe bağlı: generate (varsayılan), edit veya extend.
duration	İsteğe bağlı: 4–30 tam sayı veya -1. Düzenlemede atlayın ya da -1 kullanın. Yalnızca planlama bağlamıdır, video parametrelerini ayarlamaz.
references	İsteğe bağlı: benzersiz label (1–64 karakter) ve description (1–2000 karakter) içeren en fazla 50 açıklama. Medya indirilmez veya analiz edilmez.

Yanıt

Standart Chat Completions JSON: sonuç choices[0].message.content, kullanım usage alanındadır. Video görev kimliği dönmez. finish_reason, stop değilse, özellikle length ise bütünlüğü kontrol edin.

{
  "object": "chat.completion",
  "model": "gemini-3.1-flash-lite",
  "choices": [
    {
      "index": 0,
      "message": {
        "role": "assistant",
        "content": "A cat sits beside a rain-covered window, watching the drops slide down the glass. It slowly turns its head toward the camera."
      },
      "finish_reason": "stop"
    }
  ],
  "usage": {
    "prompt_tokens": 600,
    "completion_tokens": 50,
    "total_tokens": 650
  }
}

Referans açıklamaları

{
  "model": "gemini-3.1-flash-lite",
  "prompt": "Use @Image1 for the person and @Video1 for the camera movement.",
  "language": "tr",
  "references": [
    {
      "label": "@Image1",
      "description": "Person appearance only; ignore the background."
    },
    {
      "label": "@Video1",
      "description": "Slow camera push-in only; ignore the people."
    }
  ]
}

Hatalar ve ücretlendirme

400 geçersiz JSON, tür, alan veya değer; 401 geçersiz Key; 403 izin yok; 413 64 KiB üzeri; 415 JSON değil; 429 hız sınırı. Sağlayıcı hataları metin hizmetinin biçimini ve durumunu korur.

Metin modelinin token ve grup fiyatları, bakiye denetimi, günlükleri ve hata hesaplaşması geçerlidir. Sistem talimatları ve açıklamalar girdi tokenlarına dahildir. Burada video ücreti yoktur; sonraki video üretimi ayrıca ücretlendirilir.

İnceledikten sonra video üretin

Tam sonucu video isteğinin prompt alanına aktarın. Medyayı, süreyi ve oranı ayrıca gönderin. Etiketler medya sırası ve rolüyle eşleşmelidir. Medya incelenmediğinden kimlik tutarlılığı, kesin altyazı veya kare düzeyinde zamanlama garanti edilmez.

Seedance 2.5

Sınırlar

Yalnızca akışsız metin. stream, messages, webhook ve medya URL’leri dahil bilinmeyen üst düzey alanlar reddedilir. Gizli anahtarları girmeyin.