Seedance 프롬프트 최적화 API

APIMaster의 독립적인 텍스트 최적화 서비스로, 영상 작업을 만들지 않습니다. Volcengine 공개 가이드를 참고했으며 Seedance 공식 API가 아니고 공식 Skill을 배포하지 않습니다.

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

APIMaster API Key로 인증합니다. model은 과금할 텍스트 모델이며 사용 가능한 경로와 Key 권한이 필요합니다. 영상 모델은 target_model로 지정하고 현재 seedance-2.5만 지원합니다. 예시 모델을 사용할 수 없으면 바꾸세요.

빠른 시작

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": "ko",
  "task": "generate",
  "duration": 5
}'

매개변수

JSON
model	필수. 최적화에 사용할 유료 텍스트 모델 ID.
prompt	필수. 1–12000자. 참조 라벨과 대사를 유지하세요.
target_model	선택. 기본값이며 유일한 지원 값은 seedance-2.5.
language	선택. 출력 언어(예: ko, en). 생략하면 입력 언어. 최대 64바이트.
task	선택. generate(기본), edit, extend.
duration	선택. 정수 4–30 또는 -1. 편집은 생략하거나 -1. 구성 참고용이며 생성 매개변수를 설정하지 않습니다.
references	선택. 최대 50개. 고유 label(1–64자)과 description(1–2000자). 미디어를 가져오거나 분석하지 않습니다.

응답

표준 Chat Completions JSON입니다. 결과는 choices[0].message.content, 사용량은 usage에 있습니다. 영상 작업 ID는 없습니다. finish_reason이 stop이 아니면, 특히 length이면 완전성을 확인하세요.

{
  "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
  }
}

참조 소재 설명

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

오류 및 요금

400 JSON·타입·필드·값 오류, 401 잘못된 Key, 403 권한 없음, 413 64 KiB 초과, 415 JSON 아님, 429 속도 제한. 업스트림 오류는 텍스트 중계 형식과 상태를 유지합니다.

텍스트 모델과 그룹의 토큰 요금, 잔액 검사, 로그, 실패 정산을 따릅니다. 시스템 지시와 참조 설명도 입력 토큰입니다. 영상 요금은 없으며 후속 영상 생성은 별도 과금합니다.

검토 후 영상 생성

전체 결과를 영상 요청의 prompt로 전달하세요. 실제 미디어, 길이, 비율은 별도로 보내고 라벨을 소재 순서와 역할에 맞추세요. 미디어를 확인하지 않으므로 인물 일관성, 정확한 자막, 프레임 단위 타이밍은 보장하지 않습니다.

Seedance 2.5

제한

비스트리밍 텍스트만 지원합니다. stream, messages, webhook, 미디어 URL 등 알 수 없는 최상위 필드는 거부됩니다. 비밀 키를 넣지 마세요.