> ## Documentation Index
> Fetch the complete documentation index at: https://docs.toapis.com/llms.txt
> Use this file to discover all available pages before exploring further.

# クイックスタート

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

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

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

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

1. [API Key Management](https://toapis.com/dashboard/tokens) を開く
2. サインインして API キーを作成する
3. キーは一度だけ表示されるため、安全に保存する

## ステップ 2: モデルを選択

| 種類 | 推奨モデル | 説明 |
| - | - | - |
| テキスト | `gpt-5.6-terra` | チャットや Agent ワークフロー向けのバランス型モデル |
| 画像 | `gpt-image-2` | テキスト生成と参照画像生成に対応 |
| 動画 | `seedance-2` | テキスト, 最初と最後のフレーム画像, マルチモーダル参照から動画を生成 |

利用可能なモデルは [モデル一覧 API](https://docs.toapis.com/docs/ja/api-reference/chat/list-models.md) と各モデルのページで確認してください。

## ステップ 3: リクエストを送信

### テキスト生成

```bash theme={null}
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": "自己紹介してください"}
    ]
  }'
```

### 画像生成

```bash theme={null}
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
  }'
```

### 動画生成

```bash theme={null}
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 を返すため、種類に対応したエンドポイントを使用します。

```bash theme={null}
# 画像タスク
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](https://docs.toapis.com/docs/ja/api-reference/webhooks/task-webhooks.md)。

## 次のステップ

> **[API ドキュメント](https://docs.toapis.com/docs/ja.md)**
>
> エンドポイント、モデル、パラメータを確認します。

> **[Claude Code 連携](https://docs.toapis.com/docs/ja/integrations/claude-code.md)**
>
> Claude Code で ToAPIs を使用します。

> **[Codex 連携](https://docs.toapis.com/docs/ja/integrations/codex.md)**
>
> CC Switch 経由で Codex に ToAPIs を接続します。


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.