アカウントとキーは、引き続きコンソールでご自身で作成する必要があります。「キーを取得した」から「コードが動作する」までのすべてを、以下の3つの方法のいずれかを通じてAIに任せられます。
パスを選択
スキル · チャットエージェント
OpenClaw、Claude Codeなど、スキルシステムを備えたエージェントです。スキルを一度インストールすれば、自然言語でAPIYIを呼び出せます。
CLI · ターミナル
コードは不要です。キーを確認し、モデルを一覧表示し、メッセージを送信して、ターミナルから画像を生成できます。
npx apiyi@latest checkのインストールは不要です。開発キット · コーディングエージェント
Cursor、Claude Code、Codexは、統合コードを書く前にコントラクトとモデルレジストリを読み込みます。存在しないエンドポイントを作ることはありません。
キットの内容
すべてのファイルは公開されています。ログインは不要で、どのエージェントからでも直接取得できます。コーディングエージェント向けルール
コーディングエージェントで最もよくある失敗は、コードが悪いことではありません。記憶を頼りに書くことです。存在しないエンドポイントを作り出したり、gpt-5-4-miniの代わりにgpt-5.4-miniと入力したり、Anthropic SDKのベースURLに余分な/v1を追加したりすることです。次の5つのルールで防止できます。
- エンドポイント、パラメータ名、列挙値、レスポンス形式を作り出さないでください。
skill.mdエンドポイント表に記載されたパスだけを使用してください。パラメータは、使用するプロトコル（OpenAI、Anthropic、Gemini）の公式定義に従います。 model-registry.jsonをモデル IDの唯一の信頼できる情報源とします。 IDはドット区切りのバージョン表記で、大文字と小文字が区別されます。ドキュメントURL内のハイフンはURLで安全に使用するための置き換えであり、モデル IDではありません。- ベースURLはモデルではなくSDKで選択してください。 OpenAI SDKでは
https://api.apiyi.com/v1を使用し、Anthropic SDKではルートのhttps://api.apiyi.comを使用します。Google GenAI SDKでは、ルートにapi_versionを設定し、その値をv1betaにします。 - キーは
APIYI_API_KEY環境変数からのみ読み取ってください。 ハードコードしたり、コミットしたり、チャットに貼り付けたりしないでください。 - まず説明し、その後に編集してください。 エージェントに、使用するエンドポイント、モデル、タイムアウトを伝えさせます。あなたが確認してからコードを編集させてください。
Cursor、Claude Code、Codex、その他のコーディングエージェント向けの完全なプロンプトです。そのままコピーして貼り付けてください。
このプロンプトで防げること
このプロンプトで防げること
スキル
スキルそのものがskill.mdです。これは機械向けに書かれた統合リファレンスです。インストールすると、APIYIを呼び出す必要があるときに、エージェントがこれらのルールを毎回参照します。インストール方法は3つあります。
- npx skills（汎用）
- OpenClaw
- 手動コピー
Claude Code、Cursor、Codex、およびAgent Skills仕様をサポートするその他のツールの場合：検出はこのサイトの
/.well-known/agent-skills/index.jsonを通じて行われます。これにより、スクリプトを使わずにskill.md自体がインストールされます。セルフチェックにはnpx apiyi@latest checkを使用してください。OpenClaw、Claude Code、Cursor、およびスキルをサポートするその他のエージェント向けです。そのままコピーして貼り付けてください。
キーがエージェントに届く仕組み
- **環境変数
APIYI_API_KEYが最初に使用されます。**スキル、CLI、およびこれらのドキュメント内のすべての例は、そこから読み取ります。 - OpenClawは
~/.openclaw/openclaw.json内のskills.entries.apiyi.apiKeyにキーを保存し、実行時にAPIYI_API_KEYとして注入します。これは、スキルのfrontmatterにあるprimaryEnvフィールドで宣言されています。ファイル構成については、OpenClaw設定ファイルを参照してください。 - CLIは
npx apiyi@latest auth set-keyを使用して、~/.config/apiyi/config.jsonにモード0600で保存します。
セルフチェックのステータス
スキルスクリプト、CLI、および手動のcurlは、いずれも同じステータスセットを返します。CLI
コードを書かずにターミナルから最初の呼び出しを実行できます。Node 18 以降で、インストールは不要です。ターミナルコマンドを実行できるエージェントに依頼するか、これらの行を自分で実行してください。
コマンド
グローバルフラグ：
--api-key、--node api|vip|b|cf（ノードを選択）、--base-url、--timeout、--json（機械可読な出力）。
Key の検索順序
--api-key フラグ、次に APIYI_API_KEY 環境変数、次に ~/.config/apiyi/config.json、最後に OpenClaw の ~/.openclaw/openclaw.json の順です。OpenClaw のスキルをすでにインストールしている場合、CLI はその key を再利用します。
終了コード
スクリプトやエージェントは、テキストを解析するのではなく終了コードに基づいて分岐します。
ソースコードは
github.com/apiyi-com/cli にあり、npm パッケージは apiyi です。古いバージョンをキャッシュする npx があるため、ドキュメントでは常に npx apiyi@latest と記述します。
model-registry.json のフィールド
価格表が更新されるたびに、モデル価格ページと同じデータから再生成されます。トップレベルのフィールド：
各モデルエントリ：
レジストリ内の価格は定価です。チャージボーナスとグループ割引は含まれておらず、実際の課金はコンソールに従います。グループについては、グループの説明を参照してください。
関連ページ
はじめに
2つの方法があります。AIに統合させるか、自分で行います。
ワンクリック統合はありますか？
ボタンではなく、ドキュメントをAIに渡す形で利用できます。
OpenClaw
オープンソースのローカルAIアシスタントです。スキルをインストールすると、自然言語でAPIYIを呼び出せます。
モデルの料金
レジストリを人間が読みやすい形式にしたもので、ベンダーごとにグループ化し、段階的な料金を掲載しています。