# ai& API Documentation

> OpenAI- and Anthropic-compatible inference platform serving open-weight LLMs from our own infrastructure.

完全なコーパスは /ja/llms-full.txt にあります。

## Analytics

- [リクエストログ](https://aiand-docs-staging.pages.dev/ja/analytics/logs/): 組織のリクエスト単位ログを、カーソルページネーション付きで取得。
- [メトリクス](https://aiand-docs-staging.pages.dev/ja/analytics/metrics/): 組織の使用量を時系列で取得 — リクエスト・トークン・レイテンシ・コスト。
- [サマリー](https://aiand-docs-staging.pages.dev/ja/analytics/summary/): 指定期間における組織の集計データ。

## API

- [チャット補完](https://aiand-docs-staging.pages.dev/ja/api/chat-completions/): 会話に対するモデル応答を生成する。
- [補完 (廃止)](https://aiand-docs-staging.pages.dev/ja/api/completions/): レガシーの /v1/completions エンドポイントは廃止されました。代わりにチャット補完を使用してください。
- [ライフサイクルと有効期限](https://aiand-docs-staging.pages.dev/ja/api/file-lifecycle/): アップロード済みファイルの保持期間、自動クリーンアップ、明示的削除の方法。
- [ファイルの用途 (purpose)](https://aiand-docs-staging.pages.dev/ja/api/file-purposes/): ai& がアップロード済みファイルを分類し、どのモデルから参照できるかを制御する仕組み。
- [OpenAI と Anthropic の形式](https://aiand-docs-staging.pages.dev/ja/api/file-shapes/): Files エンドポイントは同じパスで OpenAI 形式と Anthropic 形式のレスポンスを返す。リクエストヘッダで選択。
- [ファイル](https://aiand-docs-staging.pages.dev/ja/api/files/): 推論リクエストで利用するアセット (画像、動画、音声) をアップロードして参照する。
- [メッセージ (Anthropic)](https://aiand-docs-staging.pages.dev/ja/api/messages/): Anthropic Messages API 互換レイヤー。
- [モデル](https://aiand-docs-staging.pages.dev/ja/api/models/): 利用可能なモデルと価格を一覧表示する。
- [Responses](https://aiand-docs-staging.pages.dev/ja/api/responses/): OpenAI Responses API 形式でモデル応答を生成する。
- [アップロード](https://aiand-docs-staging.pages.dev/ja/api/uploads/): 単発の /v1/files の上限を超えるファイル向けのチャンクアップロード API。OpenAI Uploads API とドロップイン互換。
- [動画](https://aiand-docs-staging.pages.dev/ja/api/videos/): テキストプロンプトから動画クリップを生成する非同期ジョブ API。

## Authentication

- [認証](https://aiand-docs-staging.pages.dev/ja/authentication/): ai& API の API キーおよび JWT 認証について。

## Billing

- [残高 API](https://aiand-docs-staging.pages.dev/ja/billing/balance/): API キーで組織のプリペイドクレジット残高を取得します。
- [クーポン](https://aiand-docs-staging.pages.dev/ja/billing/coupons/): チェックアウト時にプロモーションコードを適用して、クレジットを割引価格で購入する。
- [クレジットとチャージ](https://aiand-docs-staging.pages.dev/ja/billing/credits/): ai& 組織にクレジットを追加する方法と、消費の仕組み。
- [請求書と領収書](https://aiand-docs-staging.pages.dev/ja/billing/invoices/): クレジット購入の請求書・領収書のダウンロード。
- [支払い方法](https://aiand-docs-staging.pages.dev/ja/billing/payment-methods/): ai& アカウントのクレジットカード等の支払い方法の管理。
- [リデンプションコード](https://aiand-docs-staging.pages.dev/ja/billing/redemption-codes/): イベントコードを引き換えて、カード登録も Stripe の決済も不要でクレジットを追加する。
- [返金ポリシー](https://aiand-docs-staging.pages.dev/ja/billing/refunds/): クレジット返金の可否と未使用残高の取り扱い。
- [使用量の確認](https://aiand-docs-staging.pages.dev/ja/billing/usage/): モデル別、期間別のクレジット使用状況。

## Capabilities

- [推論](https://aiand-docs-staging.pages.dev/ja/capabilities/reasoning/): 推論モデルの推論内容が各エンドポイントでどこに返るかと、推論レベルの指定方法を説明します。
- [ストリーミング](https://aiand-docs-staging.pages.dev/ja/capabilities/streaming/): Server-Sent Events 経由でモデル出力を逐次受信。
- [構造化出力](https://aiand-docs-staging.pages.dev/ja/capabilities/structured-outputs/): モデル出力を JSON Schema に制約し、確実にパースできる形式にする。
- [ツール呼び出し](https://aiand-docs-staging.pages.dev/ja/capabilities/tool-calling/): 定義した関数をモデルに呼び出させて、データ取得やアクション実行を行う。
- [動画理解](https://aiand-docs-staging.pages.dev/ja/capabilities/video/): 動画対応モデルにアップロード済みの file_id 経由、またはインライン URL で動画クリップを渡す。
- [ビジョン](https://aiand-docs-staging.pages.dev/ja/capabilities/vision/): ビジョン対応モデルに画像を渡す — URL、base64、アップロード済み file_id の 3 方式。

## Cli

- [ai& CLI](https://aiand-docs-staging.pages.dev/ja/cli/): ターミナルからサインイン、ai& 上でのコーディングエージェントの起動、プロンプトの実行、モデル・ログ・使用量の確認を行う。

## Cookbook

- [構造化抽出](https://aiand-docs-staging.pages.dev/ja/cookbook/extraction/): JSON Schema を使って非構造テキストから型付きエンティティを抽出する。
- [ドキュメント上のチャット (RAG)](https://aiand-docs-staging.pages.dev/ja/cookbook/rag/): 自社ドキュメントを根拠にした回答を得る — コーパスをまるごとコンテキストに入れるか、収まらない場合は検索を組み合わせる。
- [ストリーミングチャット UI](https://aiand-docs-staging.pages.dev/ja/cookbook/streaming-ui/): ai& のストリーミング chat completion をブラウザに中継する Next.js ルート。
- [ツール呼び出しエージェント](https://aiand-docs-staging.pages.dev/ja/cookbook/tool-agent/): モデルが自前の Python 関数を必要なだけ呼び出せる最小エージェントループ。
- [画像からの抽出](https://aiand-docs-staging.pages.dev/ja/cookbook/vision-extraction/): レシート画像をアップロードして明細を構造化データとして取得 — Files + Vision + Structured Outputs の組み合わせ。

## Errors

- [エラーコード](https://aiand-docs-staging.pages.dev/ja/errors/): エラーレスポンスの形式とステータスコード。

## Getting Started

- [クイックスタート](https://aiand-docs-staging.pages.dev/ja/getting-started/): ゼロから ai& API の初回呼び出しまでを 5 分で。

## Overview

- [ai& API ドキュメント](https://aiand-docs-staging.pages.dev/ja/): OpenAI 互換の推論 API。クレジットベースの課金を内蔵。

## Integrations

- [Claude Code](https://aiand-docs-staging.pages.dev/ja/integrations/claude-code/): Anthropic のエージェント型コーディング CLI「Claude Code」のモデルバックエンドとして ai& を利用する。
- [Cline](https://aiand-docs-staging.pages.dev/ja/integrations/cline/): Cline の組み込み provider で ai& を利用する。
- [Cloudflare AI Gateway](https://aiand-docs-staging.pages.dev/ja/integrations/cloudflare-ai-gateway/): カスタムプロバイダとして Cloudflare AI Gateway を ai& の前に置く。
- [Codex](https://aiand-docs-staging.pages.dev/ja/integrations/codex/): OpenAI のエージェント型コーディング CLI「Codex」のモデルバックエンドとして ai& を利用する。
- [CrewAI](https://aiand-docs-staging.pages.dev/ja/integrations/crewai/): CrewAI のマルチエージェントワークフローを ai& 上で実行する。
- [Cursor](https://aiand-docs-staging.pages.dev/ja/integrations/cursor/): BYOK(Bring Your Own Key)を使って、Cursor の Agent モードのモデルバックエンドとして ai& を利用する。
- [Kilo Code](https://aiand-docs-staging.pages.dev/ja/integrations/kilo-code/): VS Code、JetBrains、CLI の Kilo Code で ai& を OpenAI 互換 provider として利用する。
- [LangChain](https://aiand-docs-staging.pages.dev/ja/integrations/langchain/): LangChain / LangGraph アプリの LLM プロバイダとして ai& を利用する。
- [LlamaIndex](https://aiand-docs-staging.pages.dev/ja/integrations/llamaindex/): LlamaIndex のパイプラインとエージェントで ai& を LLM として利用する。
- [OMP](https://aiand-docs-staging.pages.dev/ja/integrations/omp/): OMP の組み込み provider で ai& を利用する。
- [OpenAI Agents SDK](https://aiand-docs-staging.pages.dev/ja/integrations/openai-agents/): ベース URL を切り替えるだけで OpenAI Agents SDK を ai& 上で動かす。
- [OpenCode](https://aiand-docs-staging.pages.dev/ja/integrations/opencode/): terminal、CLI、デスクトップアプリで OpenCode から ai& を利用する。ai& は OpenCode 組み込みの provider なので、API キーを貼り付けるだけで設定が完了します。
- [PydanticAI](https://aiand-docs-staging.pages.dev/ja/integrations/pydantic-ai/): 型安全なエージェントと構造化出力を提供する PydanticAI で ai& を利用する。
- [Vercel AI SDK](https://aiand-docs-staging.pages.dev/ja/integrations/vercel-ai/): Vercel AI SDK で Next.js のストリーミング UI / React Server Components から ai& を利用する。

## Migrating Anthropic

- [Anthropic からの移行](https://aiand-docs-staging.pages.dev/ja/migrating-anthropic/): ベース URL と API キーを 2 行変更するだけで、既存の Anthropic SDK コードを ai& API に向けられます。

## Migrating Openai

- [OpenAI からの移行](https://aiand-docs-staging.pages.dev/ja/migrating-openai/): ベース URL と API キーを 2 行変更するだけで、既存の OpenAI SDK コードを ai& API に向けられます。

## Models

- [モデルの自動選択](https://aiand-docs-staging.pages.dev/ja/models/auto/): モデル名に `auto` を指定すると、ai& がリクエストごとに、組織が利用可能なモデルの中から 1 つを解決します。
- [モデルカタログ](https://aiand-docs-staging.pages.dev/ja/models/catalog/): ai& で提供しているモデル一覧 — capability、コンテキストウィンドウ、100 万トークンあたりの単価。
- [料金](https://aiand-docs-staging.pages.dev/ja/models/pricing/): トークン単位の課金、単価の確認方法、リクエストごとのコスト計算。

## Organizations

- [組織の API キー](https://aiand-docs-staging.pages.dev/ja/organizations/api-keys/): 組織にスコープされた API キーの作成と管理。
- [組織](https://aiand-docs-staging.pages.dev/ja/organizations/concepts/): ai& がユーザー、組織、メンバーシップ、課金スコープをどうモデル化しているか。
- [メンバーとロール](https://aiand-docs-staging.pages.dev/ja/organizations/members/): 組織への協力者の招待と権限管理。
- [組織の切り替え](https://aiand-docs-staging.pages.dev/ja/organizations/switching/): ai& API 呼び出し時にアクティブな組織を選択する方法。
- [ゼロデータリテンション](https://aiand-docs-staging.pages.dev/ja/organizations/zero-data-retention/): リクエストの処理が終わった後、プロンプト、レスポンス、アップロードを ai& が一切保存しない組織の設定。

## Reference

- [レート制限](https://aiand-docs-staging.pages.dev/ja/reference/rate-limits/): 組織単位・ティア別のリクエストおよびトークンレート制限。
- [レスポンスヘッダ](https://aiand-docs-staging.pages.dev/ja/reference/response-headers/): ai& がレスポンスに付与するカスタムヘッダと、リクエスト単位のコストメトリクスのオプトイン方法。
- [ストリーミングイベント](https://aiand-docs-staging.pages.dev/ja/reference/streaming-events/): ai& が送出する SSE イベント (末尾の metrics イベントを含む)。

## SDKs

- [ai& SDK](https://aiand-docs-staging.pages.dev/ja/sdks/aiand/): ai& 公式の Python / TypeScript SDK。
- [Anthropic SDK](https://aiand-docs-staging.pages.dev/ja/sdks/anthropic/): 公式 anthropic Python / Node SDK で ai& を利用する。
- [curl](https://aiand-docs-staging.pages.dev/ja/sdks/curl/): curl で直接 ai& API を叩く — テストやシェルスクリプトに便利。
- [OpenAI SDK](https://aiand-docs-staging.pages.dev/ja/sdks/openai/): 公式 openai Python / Node SDK で ai& を利用する。