---
title: "クイックスタート"
description: "1折AI APIキーを作成し、curl または SDK で Claude / GPT を呼び出し、よく使うクライアントに接続します。"
headingIds: {"GPT から始める場合も":"section-1","次のステップ":"section-2"}
---
目標：5分以内に API キー（API key）を取得し、最初の Claude または GPT リクエストを完了します。
[1zheai.com/register](https://1zheai.com/register?lng=ja) にアクセスして登録します。呼び出しは従量課金で残高から差し引かれるため、先にチャージする必要があります。残高は米ドル建てで、WeChat Pay、Alipay、Stripe（クレジットカード）、USDT に対応しています。利用可能な方法と金額制限はウォレットの注文ページに従います。チャージ後7日以内に、未使用の元本を元の支払い方法に払い戻し申請できます。すでに消費した分と支払い処理サービス料は返金されません。ルールは[チャージ、返金と請求書](/ja/docs/billing/)を参照してください。
[コンソール](https://1zheai.com/console?lng=ja) に入り、左メニューの「API キー」をクリックし、右上の「API キーを作成」をクリックして、名前を入力して保存します。API キーは `sk-` で始まります。リスト内のコピーアイコンをクリックしてコピーし、保存してください。詳細は[API キーの取得と管理](/ja/docs/api-keys/)を参照してください。
API キーを環境変数に設定し、curl で Anthropic ネイティブインターフェースを一度呼び出します：
```bash title="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"}]
}'
```
```powershell title="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 に実測したレスポンスです：
```json
{
"model": "claude-sonnet-5-5",
"id": "msg_011Cg3G8HQmyTrnqSBX6o6Pw",
"type": "message",
"role": "assistant",
"content": [
{
"type": "text",
"text": "HTTP(超文本传输协议)是一种基于请求-响应模式的应用层协议,用于在客户端(如浏览器)和服务器之间传输网页、图片、API 数据等内容。"
}
],
"container": null,
"stop_reason": "end_turn",
"stop_sequence": null,
"stop_details": null,
"usage": {
"input_tokens": 530,
"cache_creation_input_tokens": 0,
"cache_read_input_tokens": 0,
"cache_creation": {
"ephemeral_5m_input_tokens": 0,
"ephemeral_1h_input_tokens": 0
},
"output_tokens": 69,
"output_tokens_details": {"thinking_tokens": 0},
"service_tier": "standard",
"inference_geo": "global"
},
"input_transformations": [],
"diagnostics": null,
"context_management": {"applied_edits": []}
}
```
`input_tokens` はこの質問文自体より数百多く、これはこの種のクライアント（curl、SDK、サードパーティツール）が毎回のリクエストに付加するシステムプロンプトで、入力として課金されます。Claude Code は付加しません。詳細は[システムプロンプトの課金](/ja/docs/pricing-explained/#section-3)を参照してください。
次にコンソール左側の「呼び出しログ」を開くと、先ほどの1件が確認できます：時間、使用した API キー（「トークン」列）、モデル、入力 / 出力トークン、キャッシュ読み書き、料金。
## GPT から始める場合も
OpenAI SDK を使用している場合や Codex に接続する場合は、GPT プロトコルを直接選択できます。同じターミナルで上記の `ONEZHE_API_KEY` を設定した上で、次を実行します：
```bash
curl --fail-with-body https://1zheai.com/v1/chat/completions \
-H "Authorization: Bearer $ONEZHE_API_KEY" \
-H "Content-Type: application/json" \
-d '{"model":"gpt-5.6-sol","messages":[{"role":"user","content":"用一句话解释 HTTP。"}]}'
```
ここは macOS / Linux のシェル例です。Windows では[クロスプラットフォーム Python / Node.js の例](/ja/docs/code-examples/) を直接実行できます。テキストは `choices[0].message.content` にあり、モデルがリストにない場合は先に[利用可能なモデルの照会](/ja/docs/api-models/) を行ってください。Codex は Responses が必要です。[Codex 設定チュートリアル](/ja/docs/quickstart-codex/) に従って接続してください。
## 次のステップ
よく使うツールに接続します：
環境変数2つだけで済みます。
設定ファイルを手で編集したくない場合はこちら。
カスタム Base URL の書き方と制限。
既存の OpenAI コードで base_url のみ変更。
リクエストが失敗した場合は、まず[エラーコードとトラブルシューティング](/ja/docs/troubleshooting/) を確認してください。返却されるフィールドと使用量を照合したい場合は、[モデルと使用量の照合](/ja/docs/verify-model/) を参照してください。