クイックスタート
ToAPIs でテキスト、画像、動画モデルを呼び出す
中国本土のユーザー向け: 中国本土のユーザーは https://toapis.cn を API エンドポイント(Base URL)としてご利用ください。本ドキュメント内の例では https://toapis.com を https://toapis.cn に置き換えてください。
ToAPIs は OpenAI 互換のテキスト API と、統一された非同期の画像・動画生成 API を提供します。このガイドでは、現在利用可能なモデルで最初のリクエストを送信します。
ステップ 1: API キーを取得
- API Key Management を開く
- サインインして API キーを作成する
- キーは一度だけ表示されるため、安全に保存する
ステップ 2: モデルを選択
| 種類 | 推奨モデル | 説明 |
|---|---|---|
| テキスト | gpt-5.6-terra | チャットや Agent ワークフロー向けのバランス型モデル |
| 画像 | gpt-image-2 | テキスト生成と参照画像生成に対応 |
| 動画 | seedance-2 | テキスト, 最初と最後のフレーム画像, マルチモーダル参照から動画を生成 |
利用可能なモデルは モデル一覧 API と各モデルのページで確認してください。
ステップ 3: リクエストを送信
テキスト生成
curl --request POST \
--url https://toapis.com/v1/chat/completions \
--header "Authorization: Bearer YOUR_API_KEY" \
--header "Content-Type: application/json" \
--data '{
"model": "gpt-5.6-terra",
"messages": [
{"role": "user", "content": "自己紹介してください"}
]
}'画像生成
curl --request POST \
--url https://toapis.com/v1/images/generations \
--header "Authorization: Bearer YOUR_API_KEY" \
--header "Content-Type: application/json" \
--data '{
"model": "gpt-image-2",
"prompt": "映画のような光に照らされたかわいいパンダ",
"size": "1:1",
"resolution": "1k",
"n": 1
}'動画生成
curl --request POST \
--url https://toapis.com/v1/videos/generations \
--header "Authorization: Bearer YOUR_API_KEY" \
--header "Content-Type: application/json" \
--data '{
"model": "seedance-2",
"prompt": "海岸に打ち寄せる波、映画のようなカメラワーク",
"duration": 5,
"aspect_ratio": "16:9",
"resolution": "720p"
}'ステップ 4: 非同期タスクを確認
テキストは直接結果を返します。画像と動画はタスク ID を返すため、種類に対応したエンドポイントを使用します。
# 画像タスク
curl https://toapis.com/v1/images/generations/YOUR_TASK_ID \
-H "Authorization: Bearer YOUR_API_KEY"
# 動画タスク
curl https://toapis.com/v1/videos/generations/YOUR_TASK_ID \
-H "Authorization: Bearer YOUR_API_KEY"Task Webhook の設定
Token に HTTPS URL と署名 secret を設定し、必要なら同一 origin の callback_url を送信します。raw body と X-ToAPIs-Webhook-* を HMAC-SHA256 で検証し、event ID を冪等処理します。照会はフォールバックにし、429 では Retry-After を使用します。Webhook。