エラーコード

Seedance 2.5 をお探しですか？ Seedance 2.5（ネイティブ 4K・30s・最大 50 の参照）は 2026 年 6 月 23 日に発表され、公開 API は 2026 年 7 月上旬に提供予定です。2.5 の公式 model ID とパラメータはまだ公開されていません — このページは現在利用可能な Seedance 2.0 API を説明します。API アクセスを取得 →。

API は標準的な HTTP ステータスコードを使用し、一貫したレスポンスフォーマットで詳細なエラー情報を返します。

HTTP ステータスコード

コード意味
200成功
400Bad Request — 無効なパラメータ
401Unauthorized — 無効または期限切れのトークン
402Payment Required — クォータ不足
403Forbidden — このリソースへのアクセスが拒否されました
404Not Found — リソースが存在しません
413Payload Too Large — リクエストボディが大きすぎます
429Too Many Requests — レート制限を超過しました
500Internal Server Error
502Bad Gateway — 上流の AI サービスが利用不可
503Service Unavailable — 一時的な過負荷

エラーレスポンスのフォーマット

すべてのエラーは一貫した JSON 構造で返されます。

{
    "error": {
        "code": 400,
        "message": "Invalid prompt parameter",
        "type": "invalid_request_error",
        "param": "prompt",
        "fallback_suggestion": "provide a valid prompt"
    }
}

エラーレスポンスのフィールド

フィールド型説明
error.codeintegerHTTP ステータスエラーコード
error.messagestring人間が読めるエラーの説明
error.typestringエラータイプのカテゴリ（下記参照）
error.paramstring関連するパラメータ名（該当する場合）
error.fallback_suggestionstringエラーを解決するための推奨アクション

エラータイプ

タイプHTTP コード説明
invalid_request_error400リクエストパラメータが無効または不足しています
authentication_error401無効または期限切れの API トークンです
insufficient_quota_error402アカウントのクレジットが不足しています。こちらでチャージ
permission_error403このモデルまたはリソースへのアクセス権限がありません
not_found_error404リクエストされたリソース（モデル、タスク）が見つかりません
request_too_large_error413リクエストボディがサイズ制限を超えています
rate_limit_error429リクエストが多すぎます — 指定された間隔後にリトライしてください
internal_server_error500内部サーバーエラー — しばらくしてから再試行してください
upstream_error502上流の AI サービスが利用不可 — 別のモデルをお試しください
service_unavailable_error503サービスが一時的に利用不可 — 30 秒後にリトライしてください

エラーの処理

import requests

response = requests.post(
    "https://api.evolink.ai/v1/videos/generations",
    headers=headers,
    json=payload
)

if response.status_code == 200:
    task = response.json()
    print(f"Task created: {task['id']}")
elif response.status_code == 429:
    # Rate limited — back off and retry
    print("Rate limited. Retrying...")
elif response.status_code == 402:
    print("Insufficient credits. Please top up at https://evolink.ai/dashboard/billing")
else:
    error = response.json().get("error", {})
    print(f"Error [{error.get('type')}]: {error.get('message')}")
    if error.get("fallback_suggestion"):
        print(f"Suggestion: {error.get('fallback_suggestion')}")

失敗した生成について

  • 失敗したビデオ生成はアカウントに課金されません
  • 失敗の詳細については 非同期タスク でタスクステータスを確認してください
  • ほとんどのエラーはパラメータを調整してリトライすることで解決できます

関連ドキュメント

現在の API アクセス状況を見る