マーケットサポート← アプリに戻る

入力ファイルの提供

画像・動画・音声を入力として受け取るモデルは、それらを input オブジェクト内の公開 HTTPS URL として読み込みます — 別途アップロードエンドポイントはありません。

入力ファイルの仕組み

ファイルを公開 HTTPS で提供できる場所にホストし、モデルの input フィールド(例:image_url)でその URL を参照します:

JSON
{
  "model": "bytedance/seedance-2-image-to-video",
  "input": {
    "image_url": "https://your-cdn.example.com/photo.jpg",
    "prompt": "cinematic slow push-in"
  }
}
ホスト済み URL を使用

ファイルは既にオンライン — URL を直接渡す

Base64 データから

先にデコードして保存し、URL を渡す

ローカルファイルから

先にご自身のストレージへアップロードし、URL を渡す

URL の要件

  • 公開アクセス可能 — 前段にログイン、cookie、IP 許可リストがないこと。
  • 有効な証明書を持つ HTTPS
  • ファイルを直接返す — URL は HTML プレビューページではなく、メディアのバイト(正しい Content-Type)を返す必要があります。
  • ファイルサイズは適切に。非常に大きなソースはタスクを遅くしたり上流で失敗したりします。

タスク送信前のクイックセルフチェック:

cURL
curl -I "https://your-cdn.example.com/photo.jpg"
# expect: HTTP/2 200 + Content-Type: image/jpeg

エンドツーエンドの例

cURL
# 1) start the task, referencing your hosted file
curl -X POST "https://97ai.97claude.com/api/generate" \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "bytedance/seedance-2-image-to-video",
    "input": {
      "image_url": "https://your-cdn.example.com/photo.jpg",
      "prompt": "cinematic slow push-in"
    }
  }'
# → { "taskId": "task_12345678", "state": "waiting" }

# 2) poll until success / fail
curl "https://97ai.97claude.com/api/generate/task_12345678" \
  -H "Authorization: Bearer $API_KEY"

ファイルのホスト先

  • ご自身のオブジェクトストレージ:AWS S3、Alibaba Cloud OSS、Tencent Cloud COS、Cloudflare R2(公開バケットまたは署名付き URL)
  • アプリの既存 CDN または静的ファイルサーバー
  • 直接ファイル URL を返す任意の画像/ファイルホスティングサービス
署名付き URL も利用可能
有効期限付きの署名付き URL(S3/OSS/COS)でも問題ありません — タスク実行中の数分間、有効であることを確認してください。

よくある問題

  • 403 / ホットリンク保護 — ホストが非ブラウザのリクエストをブロックしています。referer チェックを無効化するか署名付き URL を使用してください。
  • ファイルではなく HTML — 直接ファイル URL ではなく共有ページのリンク(Google Drive、クラウドドライブ)を渡しています。
  • Localhost / LAN の URLhttp://localhost/… やプライベート IP はプラットフォームから到達できません。

サポート

[email protected] にメールするか、各モデルページで正確な input フィールドをご確認ください。