Claude API 呼び出しの基本

チャネルと課金の要点:

デフォルトチャネル: AWS Claude（AWS Bedrock 公式）— 高い安定性、優れたキャッシュヒット率。
バックアップチャネル: Claude Official（公式キーを使った Anthropic API 直結）— AWSチャネルに問題があるときは自動フェイルオーバーします。
両チャネルとも純正の公式パススルーです。 従量課金、レート制限なし、総額コストは ≈ 定価の85%（入金ボーナスを重ねた後で79%〜86%の範囲）。

当社は低コストのリバースエンジニアリングされたアクセスは提供しません — 信頼でき、安定した品質とサービスのみです。Claudeアクセス市場は少し混沌としており、価格が安いほど、たいてい中身が不透明になります。そうした低コストチャネルでは、何が混ぜられているのか分かりません — リバースエンジニアリングのハック、共有アカウント、簡略化されたモデルや、こっそり差し替えられたモデルなどです。さらに悪いことに、会話データが転売されても、知ることはできません。APIYI は純正の公式パススルーのみ（AWS Bedrock + 公式 Anthropic キー）を提供します。追跡可能なチャネルで、データ保持はありません。多少コストが上がっても、安定してクリーンな状態を保ちたいのです。

API Keyを取得する

ダッシュボードで token を作成または管理します: https://api.apiyi.com/token

default token はそのまま利用できます。
ClaudeCode グループで新しい token を作成すると、5%割引（定価の95%）になります。
そのグループ割引は10%〜20%のチャージボーナスと併用でき、実質コストは定価の約**79%〜86%**まで下がります（「≈ 85%」という見出し）。
レート制限なし、公式サイトより安く、使いやすいです。

API は月額サブスクリプションではなく従量課金です。料金は事前チャージした残高からリアルタイムで差し引かれます。

エンドポイント

項目	値
ベース URL	`https://api.apiyi.com`
Anthropic ネイティブエンドポイント	`https://api.apiyi.com/v1/messages`
OpenAI互換エンドポイント	`https://api.apiyi.com/v1/chat/completions`

利用可能なモデル

次の3つは各ファミリーで最新のモデルです。直接の利用に推奨されます。

ファミリー	モデル	最適な用途
Opus	`claude-opus-4-8`	複雑なコーディング、深い推論
Sonnet	`claude-sonnet-4-6`	一般的な知能、日常的なコード
Haiku	`claude-haiku-4-5-20251001`	高速な応答、高い同時実行数

呼び出し形式: ネイティブ vs OpenAI互換

当社は Anthropic ネイティブ形式 と OpenAI互換形式 の両方をサポートしていますが、用途に合ったほうを選んでください。

✅ 強く推奨: Anthropic ネイティブ

エンドポイント: /v1/messagesClaude Code、Cline、Cursor、または Claude を多用するクライアントを使う場合は、ネイティブ形式を使用してください。ネイティブ形式だけが Prompt Cache（キャッシュ課金） を正しく発動し、長いコンテキスト / 繰り返しのシステムプロンプトにかかるコストを大幅に下げます。

⚙️ 汎用: OpenAI互換

エンドポイント: /v1/chat/completionsもしプロジェクトがすでに OpenAI SDK 上にあり、キャッシュ課金を気にしない のであれば、ほぼ移行コストなしで Claude に切り替えられます。単発スクリプト、軽いワークロード、そして OpenAI SDK に固定されたレガシープロジェクトに最適です。

キャッシュ課金は Anthropic ネイティブ形式でしか機能しません。 Claude Code 形式のような高頻度・長コンテキストの利用では、OpenAI互換形式は請求額が実質的に高くなる可能性があります。これは上流のプロトコル制約であり、APIYI の問題ではありません。

Prompt caching の仕組みと確認方法の詳細は、Claude Prompt Caching Guide をご覧ください。

例

Anthropic ネイティブ形式（推奨）

curl https://api.apiyi.com/v1/messages \
  -H "x-api-key: your-apiyi-key" \
  -H "anthropic-version: 2023-06-01" \
  -H "content-type: application/json" \
  -d '{
    "model": "claude-sonnet-4-6",
    "max_tokens": 1024,
    "messages": [
      {"role": "user", "content": "Hello, please introduce yourself."}
    ]
  }'

import anthropic

client = anthropic.Anthropic(
    api_key="your-apiyi-key",
    base_url="https://api.apiyi.com"
)

message = client.messages.create(
    model="claude-opus-4-8",
    max_tokens=1024,
    messages=[
        {"role": "user", "content": "Write a Python quicksort example."}
    ]
)

print(message.content[0].text)

OpenAI 互換形式（一般的な移行向け）

from openai import OpenAI

client = OpenAI(
    api_key="your-apiyi-key",
    base_url="https://api.apiyi.com/v1"
)

response = client.chat.completions.create(
    model="claude-sonnet-4-6",
    messages=[
        {"role": "user", "content": "Hello, please introduce yourself."}
    ]
)

print(response.choices[0].message.content)

Opusの料金に関する注意

Opusは比較的高価です。 日常的なチャット利用ではそれほど負担になりませんが、tokenの入力/出力が多いコーディングシナリオでは、請求額がすぐに膨らみます。実運用での消費量を見極めるために、まずは $10のテスト予算 から始めることをおすすめします。

日常利用の指針:

ほとんどのシナリオ: claude-sonnet-4-6 を優先してください — 価格性能比が最適です。
シンプル / 大量処理のタスク: claude-haiku-4-5-20251001 を使ってください — 高速で安価です。
難しいコーディング / 推論: claude-opus-4-8 に切り替えてください。

よくある質問

なぜ APIYI は、より安い「低コストの逆解析」チャネルを提供しないのですか?

「安い」の本当のコストは、見えない部分にあります。逆解析による不正利用、共有アカウント、簡略化されたモデルや密かに差し替えられたモデルは、いずれも価格を下げることができますが、チャネルの中身が何であるかは分かりません。出力品質は不安定になり、サービスは一夜にして消えることもあり、会話データが再販されても気づけません。当社は 純正の公式パススルー のみを採用しています。デフォルトのチャネルは AWS Bedrock の公式アクセス、バックアップは公式キーを使った Anthropic への直接接続です。いずれも追跡可能な従量課金で、データは保持しません。総コストはおおむね定価の 85% に収まり、これは「信頼性と安定性」と「適正価格」のあいだで守るべきちょうどよい線だと考えています。怪しく追跡不能な安価な供給源に手を出すくらいなら、多少高くても構いません。

「thinking.type.enabled is not supported for this model」と表示されますか?

これは、AWS（Bedrock）経由で Opus 4.7 / 4.8 を呼び出す際に最もよく出る 400 です。完全なメッセージは次のとおりです:

ValidationException: "thinking.type.enabled" is not supported for this model.
Use "thinking.type.adaptive" and "output_config.effort" to control thinking behavior.

原因: リクエストボディが、古い固定予算型の thinking 形式 thinking: { "type": "enabled", "budget_tokens": N } のままです。Opus 4.7 / 4.8 ではこれが廃止され、適応的 thinking のみがサポートされています。対処: type: "enabled" と budget_tokens を外し、thinking の深さは thinking: { "type": "adaptive" } + output_config.effort で制御してください。同様に、これらのモデルでは temperature / top_p / top_k も削除されており、送ると 400 になります。Claude Effort & Thinking ガイドをご覧ください。

基本

基本API

画像API（公式）

動画API（公式）

マルチモーダル理解API

テキストAPI

Claude API 呼び出しの基本

API Keyを取得する

エンドポイント

利用可能なモデル

呼び出し形式: ネイティブ vs OpenAI互換

✅ 強く推奨: Anthropic ネイティブ

⚙️ 汎用: OpenAI互換

例

Anthropic ネイティブ形式（推奨）

OpenAI 互換形式（一般的な移行向け）

Opusの料金に関する注意

よくある質問

関連リンク

​API Keyを取得する

​エンドポイント

​利用可能なモデル

​呼び出し形式: ネイティブ vs OpenAI互換

✅ 強く推奨: Anthropic ネイティブ

⚙️ 汎用: OpenAI互換

​例

​Anthropic ネイティブ形式（推奨）

​OpenAI 互換形式（一般的な移行向け）

​Opusの料金に関する注意

​よくある質問

​関連リンク

API Keyを取得する

エンドポイント

利用可能なモデル

呼び出し形式: ネイティブ vs OpenAI互換

例

Anthropic ネイティブ形式（推奨）

OpenAI 互換形式（一般的な移行向け）

Opusの料金に関する注意

よくある質問

関連リンク