# AIエージェント向けドキュメント

このドキュメントは、人だけでなくAIアシスタントにも読めるように作られています。以下のエントリーポイントのいずれかをエージェントに渡せば、
パラメータ名や価格を推測せずに、正しい統合コードを作成できます。

## エントリーポイント

| URL | 内容 |
|---|---|
| [https://doitong.com/developers/llms.txt](https://doitong.com/developers/llms.txt) | [llms.txt](https://llmstxt.org) 形式のインデックス。すべてのガイドとモデルを1行で説明します。 |
| [https://doitong.com/developers/llms-full.txt](https://doitong.com/developers/llms-full.txt) | すべてのガイド全文、注目モデルの全文、1,496個すべてのモデルの基本情報（id、作成者、価格、完全なページへのリンク）を1つのMarkdownファイルに収録しています。 |
| `/<lang>/developers/llms.txt` | 別のサイト言語でガイドを表示する同じインデックス。例: `https://doitong.com/de/developers/llms.txt`（英語がデフォルトです）。 |
| `<any page>.md` | ページのMarkdown版。例: [https://doitong.com/developers/models/flux/schnell.md](https://doitong.com/developers/models/flux/schnell.md) または [https://doitong.com/developers/docs/quickstart.md](https://doitong.com/developers/docs/quickstart.md)。 |
| `/developers/models/<id>/llms.txt` | モデルの `.md` 版と同じ内容です。 |
| [https://doitong.com/developers/openapi.json](https://doitong.com/developers/openapi.json) | コード生成ツール向けのOpenAPI 3.1。注目モデルのすべてのエンドポイントと型付きリクエスト本文を収録し、`?model=<id>`、`?category=<id>`、または `?models=all` で他のモデルも追加できます。 |
| `https://api.doitong.com/v1/models` | JSON形式のカタログ（キー不要）。 |

各モデルのMarkdownページには、USDとAPIクレジットでの価格、許可されるすべての値を含む各パラメータ、必須項目のみの例と完全な例、
レスポンス形式、curl、JavaScript、Python、MCP向けのすぐに使えるコードが掲載されています。

## AI向けにコピー

各モデルページには **Copy for AI** ボタンがあります。ページをMarkdownとしてコピーするか、Markdown版をアシスタントに参照させる
プロンプトとともにChatGPTまたはClaudeで開けます。

## 機能するプロンプト

これをClaude、ChatGPT、またはCursorに貼り付けてから、作成したいものを説明します。

```text プロンプト
I want to generate images/video/audio with the Doitong API.
Read https://doitong.com/developers/llms.txt first, then the .md page of each model you plan to use.
Facts: base URL https://api.doitong.com/v1; auth header "Authorization: Bearer <key>" with the key from the
DOITONG_API_KEY environment variable; run with POST /run/{model_id}?wait=20 and, if the status is
still queued or running, poll GET /requests/{id}?wait=20; outputs[].url are file URLs on Doitong storage
(kept forever by default; add ?storage=temporary for throwaway runs, deleted after 7 days).
Get the price first with POST /quote/{model_id} (same body): exact, or for a model charged by usage the
most the run can cost (the unused part is refunded). Prices are in USD; 1000 API credits = 1 USD.
Use the parameter names from the model page; never invent parameters.
```

## エージェント自身にモデルを呼び出させる

エージェントがメディアを直接生成できるようにするには、APIクレジットの予算が設定されたキーで[MCPサーバー](https://doitong.com/developers/docs/mcp)に接続します。
エージェントはモデルの検索、見積もり、実行、結果の取得を行うツールを利用でき、予算を超えて使用することはできません。