導入ガイド
base_url を Y-API に向けるだけで、ほかのコードは変更不要です。以下のサンプルはそのままコピーして動きますし、16 種類のモデルはすべて同じ書き方です。
ステップ 1
基本設定
OpenAI 互換の SDK なら、この 3 項目を差し替えるだけで動きます。api_key はコンソールの「API キー」ページで発行し、model には「利用できるモデル」にある ID を指定してください。
- base_url
- https://api.y-api.bestvirtualgoods.com/v1
- api_key
- sk-...（コンソールで作成）
- model
- deepseek/deepseek-v4-pro
ステップ 2
最初のリクエストを送る
3 つのサンプルはいずれも等価です。お使いのものをコピーしてください。
curl https://api.y-api.bestvirtualgoods.com/v1/chat/completions \
-H "Authorization: Bearer $YAPI_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "deepseek/deepseek-v4-pro",
"messages": [{"role": "user", "content": "こんにちは"}]
}'import os
from openai import OpenAI
client = OpenAI(
base_url="https://api.y-api.bestvirtualgoods.com/v1",
api_key=os.environ["YAPI_KEY"], # コンソールで作成したキー
)
response = client.chat.completions.create(
model="deepseek/deepseek-v4-pro",
messages=[{"role": "user", "content": "こんにちは"}],
)
print(response.choices[0].message.content)import OpenAI from 'openai'
const client = new OpenAI({
baseURL: 'https://api.y-api.bestvirtualgoods.com/v1',
apiKey: process.env.YAPI_KEY, // コンソールで作成したキー
})
const response = await client.chat.completions.create({
model: 'deepseek/deepseek-v4-pro',
messages: [{ role: 'user', content: 'こんにちは' }],
})
console.log(response.choices[0].message.content)応用
ストリーミング
stream パラメータを追加するだけです。返ってくるチャンクの形式は OpenAI と同じ SSE なので、クライアント側で特別な処理は必要ありません。
stream = client.chat.completions.create(
model="deepseek/deepseek-v4-pro",
messages=[{"role": "user", "content": "こんにちは"}],
stream=True,
)
for chunk in stream:
print(chunk.choices[0].delta.content or "", end="")応用
モデルの切り替え
すべてのモデルが同じ base_url と同じキーを共有するため、切り替えは model フィールドを書き換えるだけです。全一覧は「利用できるモデル」ページにあります。
# 低価格。高頻度・バッチ処理向け
client.chat.completions.create(model="deepseek/deepseek-v4-flash", messages=msgs)
# より高性能。複雑な推論向け
client.chat.completions.create(model="deepseek/deepseek-v4-pro", messages=msgs)トラブルシューティング
エラーハンドリング
よくあるエラーは 2 つで、いずれもコンソールのリクエストログに記録が残ります。
| ステータス | 意味 | 対処方法 |
|---|---|---|
| 401 | 意味キーが無効か、すでに失効しています。 | 対処方法コンソールの「API キー」ページでキーが残っているか確認し、必要であれば新しく発行してください。 |
| 429 | 意味アカウントのクレジットを使い切っています。 | 対処方法https://y-api.bestvirtualgoods.com/app/billing で入金すればすぐに復旧します。キーは有効なままで、コードを変更する必要もありません。 |
そのほかのステータスコードとエラーボディの構造は OpenAI の仕様に準じるため、既存のエラーハンドリングをそのまま流用できます。