入力ファイルの提供
画像・動画・音声を入力として受け取るモデルは、それらを 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 の URL —
http://localhost/…やプライベート IP はプラットフォームから到達できません。
サポート
[email protected] にメールするか、各モデルページで正確な input フィールドをご確認ください。