クイックスタート

1折AI APIキーを作成し、curl または SDK で Claude / GPT を呼び出し、よく使うクライアントに接続します。

目標：5分以内に API キー（API key）を取得し、最初の Claude または GPT リクエストを完了します。

登録してチャージする
1zheai.com/register にアクセスして登録します。呼び出しは従量課金で残高から差し引かれるため、先にチャージする必要があります。残高は米ドル建てで、WeChat Pay、Alipay、Stripe（クレジットカード）、USDT に対応しています。利用可能な方法と金額制限はウォレットの注文ページに従います。チャージ後7日以内に、未使用の元本を元の支払い方法に払い戻し申請できます。すでに消費した分と支払い処理サービス料は返金されません。ルールはチャージ、返金と請求書を参照してください。
API キーを作成する
コンソールに入り、左メニューの「API キー」をクリックし、右上の「API キーを作成」をクリックして、名前を入力して保存します。API キーは sk- で始まります。リスト内のコピーアイコンをクリックしてコピーし、保存してください。詳細はAPI キーの取得と管理を参照してください。
最初のリクエストを送信する
API キーを環境変数に設定し、curl で Anthropic ネイティブインターフェースを一度呼び出します：
macOS / Linux
Windows PowerShell
macOS / Linux
export ONEZHE_API_KEY="sk-你的Key" curl https://1zheai.com/v1/messages \ -H "x-api-key: $ONEZHE_API_KEY" \ -H "anthropic-version: 2023-06-01" \ -H "content-type: application/json" \ -d '{ "model": "claude-sonnet-5-5", "max_tokens": 128, "messages": [{"role": "user", "content": "用一句话解释什么是 HTTP"}] }'
Windows PowerShell
$env:ONEZHE_API_KEY = "sk-你的Key" $body = @{ model = "claude-sonnet-5-5" max_tokens = 128 messages = @(@{ role = "user"; content = "用一句话解释什么是 HTTP" }) } | ConvertTo-Json -Depth 5 Invoke-RestMethod -Uri "https://1zheai.com/v1/messages" -Method Post ` -Headers @{ "x-api-key" = $env:ONEZHE_API_KEY; "anthropic-version" = "2023-06-01" } ` -ContentType "application/json; charset=utf-8" ` -Body ([System.Text.Encoding]::UTF8.GetBytes($body))
ONEZHE_API_KEY はあくまで例の変数名で、何という名前にしても構いません。

レスポンスを確認する

成功時は HTTP 200 を返し、構造は公式と一致します。特に次の2点を確認してください：model がリクエストしたモデルかどうか、usage 内のトークン数です。以下は 2026-10-15 に実測したレスポンスです：

1
{
2
  "model": "claude-sonnet-5-5",
3
  "id": "msg_011Cg3G8HQmyTrnqSBX6o6Pw",
4
  "type": "message",
5
  "role": "assistant",
6
  "content": [
7
    {
8
      "type": "text",
9
      "text": "HTTP(超文本传输协议)是一种基于请求-响应模式的应用层协议,用于在客户端(如浏览器)和服务器之间传输网页、图片、API 数据等内容。"
10
    }
11
  ],
12
  "container": null,
13
  "stop_reason": "end_turn",
14
  "stop_sequence": null,
15
  "stop_details": null,
16
  "usage": {
17
    "input_tokens": 530,
18
    "cache_creation_input_tokens": 0,
19
    "cache_read_input_tokens": 0,
20
    "cache_creation": {
21
      "ephemeral_5m_input_tokens": 0,
22
      "ephemeral_1h_input_tokens": 0
23
    },
24
    "output_tokens": 69,
25
    "output_tokens_details": {"thinking_tokens": 0},
26
    "service_tier": "standard",
27
    "inference_geo": "global"
28
  },
29
  "input_transformations": [],
30
  "diagnostics": null,
31
  "context_management": {"applied_edits": []}
32
}

input_tokens はこの質問文自体より数百多く、これはこの種のクライアント（curl、SDK、サードパーティツール）が毎回のリクエストに付加するシステムプロンプトで、入力として課金されます。Claude Code は付加しません。詳細はシステムプロンプトの課金を参照してください。

次にコンソール左側の「呼び出しログ」を開くと、先ほどの1件が確認できます：時間、使用した API キー（「トークン」列）、モデル、入力 / 出力トークン、キャッシュ読み書き、料金。

GPT から始める場合も

OpenAI SDK を使用している場合や Codex に接続する場合は、GPT プロトコルを直接選択できます。同じターミナルで上記の ONEZHE_API_KEY を設定した上で、次を実行します：

1
curl --fail-with-body https://1zheai.com/v1/chat/completions \
2
  -H "Authorization: Bearer $ONEZHE_API_KEY" \
3
  -H "Content-Type: application/json" \
4
  -d '{"model":"gpt-5.6-sol","messages":[{"role":"user","content":"用一句话解释 HTTP。"}]}'

ここは macOS / Linux のシェル例です。Windows ではクロスプラットフォーム Python / Node.js の例を直接実行できます。テキストは choices[0].message.content にあり、モデルがリストにない場合は先に利用可能なモデルの照会を行ってください。Codex は Responses が必要です。Codex 設定チュートリアルに従って接続してください。

次のステップ

よく使うツールに接続します：

Claude Code

環境変数2つだけで済みます。

CC Switch

設定ファイルを手で編集したくない場合はこちら。

Cursor

カスタム Base URL の書き方と制限。

OpenAI SDK

既存の OpenAI コードで base_url のみ変更。

リクエストが失敗した場合は、まずエラーコードとトラブルシューティングを確認してください。返却されるフィールドと使用量を照合したい場合は、モデルと使用量の照合を参照してください。