ToAPIsToAPIs

クイックスタート

ToAPIs でテキスト、画像、動画モデルを呼び出す

中国本土のユーザー向け: 中国本土のユーザーは https://toapis.cn を API エンドポイント(Base URL)としてご利用ください。本ドキュメント内の例では https://toapis.com を https://toapis.cn に置き換えてください。

ToAPIs は OpenAI 互換のテキスト API と、統一された非同期の画像・動画生成 API を提供します。このガイドでは、現在利用可能なモデルで最初のリクエストを送信します。

ステップ 1: API キーを取得

  1. API Key Management を開く
  2. サインインして API キーを作成する
  3. キーは一度だけ表示されるため、安全に保存する

ステップ 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。

次のステップ

On this page