OpenAI Chat Completions 互換モード

/v1/chat/completions は LLM 業界の事実上の標準インターフェースであり、ほぼすべてのフレームワーク、クライアント、SDK が標準でサポートしています。APIYI を通じて、この単一のエンドポイントから OpenAI、Claude、Gemini、DeepSeek を含む合計 400+ モデルに到達できます。モデルの切り替えは、文字列を差し替えるだけです。

どのエンドポイントを選ぶか: 既存のフレームワーク/クライアントを使う、または複数ベンダーで 1 つのコードベースを使いたい → 互換モード（このページ）；組み込みツール（Web 検索、コードインタープリタ）や Pro-series モデルが必要 → Native Calls (/v1/responses)。OpenAI の Chat Completions に関する公式見解: 長期的にサポートされますが、新規プロジェクトでは Responses が推奨されます。どちらのエンドポイントでも、会話履歴は自分で管理する必要があります — Multi-Turn Conversation Guide を参照してください。

クイックスタート

curl https://api.apiyi.com/v1/chat/completions \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -d '{
    "model": "gpt-5.4",
    "messages": [
      {"role": "user", "content": "Introduce yourself in one sentence"}
    ]
  }'

from openai import OpenAI

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

response = client.chat.completions.create(
    model="gpt-5.4",
    messages=[{"role": "user", "content": "Introduce yourself in one sentence"}]
)

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

import OpenAI from 'openai';

const openai = new OpenAI({
  apiKey: 'YOUR_API_KEY',
  baseURL: 'https://api.apiyi.com/v1'
});

const response = await openai.chat.completions.create({
  model: 'gpt-5.4',
  messages: [{ role: 'user', content: 'Introduce yourself in one sentence' }]
});

console.log(response.choices[0].message.content);

1つのインターフェース、すべてのプロバイダー

これが互換モードの最大の利点です: モデルを切り替えるということは、コードを1行変えるのではなく、文字列を変えるだけです。

def ask(message: str, model: str) -> str:
    response = client.chat.completions.create(
        model=model,
        messages=[{"role": "user", "content": message}]
    )
    return response.choices[0].message.content

print(ask("Explain quantum entanglement", "gpt-5.4"))               # OpenAI
print(ask("Explain quantum entanglement", "claude-sonnet-4-6"))      # Anthropic
print(ask("Explain quantum entanglement", "gemini-3-pro-preview"))   # Google
print(ask("Explain quantum entanglement", "deepseek-chat"))          # DeepSeek

モデル名と価格の一覧: モデルと価格。注: 互換フォーマット経由で Claude を呼び出すと、Claude の Prompt Cache 割引は適用されません — Claude を多用する場合は、Claude ネイティブ呼び出しを使用してください。

SDK の言語別セットアップ

すべての公式 SDK はカスタム base_url をサポートしています。一度設定すれば、そのまま使えます。

Python

pip install openai

from openai import OpenAI, AsyncOpenAI

# Synchronous client
client = OpenAI(
    api_key="YOUR_API_KEY",
    base_url="https://api.apiyi.com/v1"
)

# Async client
async_client = AsyncOpenAI(
    api_key="YOUR_API_KEY",
    base_url="https://api.apiyi.com/v1"
)

コード内の設定をゼロにしたい場合は、環境変数を使うこともできます。

export OPENAI_API_KEY="YOUR_API_KEY"
export OPENAI_BASE_URL="https://api.apiyi.com/v1"

from openai import OpenAI
client = OpenAI()  # reads the environment automatically

Node.js / TypeScript

npm install openai

import OpenAI from 'openai';

const openai = new OpenAI({
  apiKey: process.env.OPENAI_API_KEY,
  baseURL: 'https://api.apiyi.com/v1'
});

const response = await openai.chat.completions.create({
  model: 'gpt-5.4-mini',
  messages: [{ role: 'user', content: 'Hello!' }],
  temperature: 0.7
});

.NET

dotnet add package OpenAI

using OpenAI;
using OpenAI.Chat;

var client = new OpenAIClient(
    new System.ClientModel.ApiKeyCredential("YOUR_API_KEY"),
    new OpenAIClientOptions { Endpoint = new Uri("https://api.apiyi.com/v1") }
);

var chatClient = client.GetChatClient("gpt-5.4");
var response = await chatClient.CompleteChatAsync("Hello!");
Console.WriteLine(response.Value.Content[0].Text);

Go

公式 OpenAI Go SDK（github.com/openai/openai-go）を使用してください。

go get github.com/openai/openai-go

package main

import (
    "context"
    "fmt"

    "github.com/openai/openai-go"
    "github.com/openai/openai-go/option"
)

func main() {
    client := openai.NewClient(
        option.WithAPIKey("YOUR_API_KEY"),
        option.WithBaseURL("https://api.apiyi.com/v1"),
    )

    completion, err := client.Chat.Completions.New(context.TODO(), openai.ChatCompletionNewParams{
        Model: "gpt-5.4",
        Messages: []openai.ChatCompletionMessageParamUnion{
            openai.UserMessage("Hello!"),
        },
    })
    if err != nil {
        panic(err)
    }
    fmt.Println(completion.Choices[0].Message.Content)
}

Java

公式 OpenAI Java SDK（com.openai:openai-java）を使用してください。

<dependency>
    <groupId>com.openai</groupId>
    <artifactId>openai-java</artifactId>
    <version>LATEST</version>
</dependency>

import com.openai.client.OpenAIClient;
import com.openai.client.okhttp.OpenAIOkHttpClient;
import com.openai.models.chat.completions.ChatCompletion;
import com.openai.models.chat.completions.ChatCompletionCreateParams;

OpenAIClient client = OpenAIOkHttpClient.builder()
    .apiKey("YOUR_API_KEY")
    .baseUrl("https://api.apiyi.com/v1")
    .build();

ChatCompletionCreateParams params = ChatCompletionCreateParams.builder()
    .model("gpt-5.4")
    .addUserMessage("Hello!")
    .build();

ChatCompletion completion = client.chat().completions().create(params);
System.out.println(completion.choices().get(0).message().content().orElse(""));

サードパーティ製ライブラリを使っているレガシーなプロジェクト（Go のsashabaranov/go-openai、Java のtheokanning パッケージ）は、base_url を変更したあとも引き続き動作しますが、上記の公式 SDK への移行をおすすめします。サードパーティ製ライブラリは、reasoning_effort などの新しいパラメータへの対応が遅れがちです。

共通機能

ストリーミング

stream = client.chat.completions.create(
    model="gpt-5.4",
    messages=[{"role": "user", "content": "Write a short poem about autumn"}],
    stream=True
)

for chunk in stream:
    if chunk.choices and chunk.choices[0].delta.content:
        print(chunk.choices[0].delta.content, end="", flush=True)

推論の制御

Chat Completions では、Responses 上のネストされた形式とは異なり、トップレベルの reasoning_effort パラメータを使用します:

response = client.chat.completions.create(
    model="gpt-5.4",
    messages=[{"role": "user", "content": "Prove that the square root of 2 is irrational"}],
    reasoning_effort="high"  # none / low / medium / high / xhigh
)

GPT-5.4 以降（gpt-5.6 シリーズを含む）では、tools と reasoning_effort はこのエンドポイントで同時指定できません: tools を指定しつつ reasoning_effort が none でない場合は 400 で失敗します — Function tools with reasoning_effort are not supported for ... in /v1/chat/completions。パラメータを省略しても、既定値が medium なので回避できません。これは OpenAI の公式な制限です — 推論と tool 呼び出しを併用する場合は、Responses エンドポイントに切り替えるか、reasoning_effort="none" を明示的に設定してください。

gpt-5 シリーズの reasoning モデルも、このエンドポイントでは temperature / top_p をサポートしていません — 指定するとエラーになります。

画像入力

response = client.chat.completions.create(
    model="gpt-5.4",
    messages=[
        {
            "role": "user",
            "content": [
                {"type": "text", "text": "What's in this image?"},
                {"type": "image_url", "image_url": {"url": "https://example.com/image.jpg"}}
            ]
        }
    ]
)

埋め込み

response = client.embeddings.create(
    model="text-embedding-3-small",
    input="Text to embed"
)
embedding = response.data[0].embedding

エラー処理と再試行

公式 SDK は自動で再試行します（既定で 2 回試行、429 / 5xx / 接続エラー時）— 手作りのループよりこちらを優先してください:

client = OpenAI(
    api_key="YOUR_API_KEY",
    base_url="https://api.apiyi.com/v1",
    max_retries=3,   # built-in exponential backoff
    timeout=60.0
)

より細かく制御する場合は、例外の種類ごとにキャッチします:

from openai import (
    APIError,
    APIConnectionError,
    RateLimitError,
    InternalServerError,
)

try:
    response = client.chat.completions.create(
        model="gpt-5.4",
        messages=[{"role": "user", "content": "Hello"}]
    )
except RateLimitError:
    print("Rate limited — retry later")
except APIConnectionError:
    print("Connection error — check network/proxy")
except InternalServerError:
    print("Upstream error — worth retrying")
except APIError as e:
    print(f"API error: {e}")

Compatibleモードの機能制限

機能	互換モード	注記
チャット / streaming / マルチモーダル入力	✅	完全対応
関数呼び出し (FC)	✅	Function Callingを参照してください
プロンプトキャッシュ割引	✅	OpenAIモデルでは自動適用です — Cache Billingを参照してください
組み込み tools（ウェブ検索、コードインタープリター、…）	❌	ネイティブ呼び出しのみ
マルチターン会話	✅	`messages`履歴を自分で保持してください（native Responses でも自己管理の履歴が必要です — マルチターンガイドを参照してください）
`verbosity`出力制御	❌	ネイティブのみ
Proシリーズのモデル (gpt-5.4-pro, …)	❌	実際には、ネイティブ呼び出しのみです

OpenAI Direct からの移行

OpenAI の公式サービスをご利用中ですか？移行は 2 ステップで、コード変更は不要です。

base_url と key を変更する

# Before
client = OpenAI(api_key="sk-...")

# After
client = OpenAI(
    api_key="YOUR_APIYI_KEY",
    base_url="https://api.apiyi.com/v1"
)

または環境変数のみを変更する（コードはそのまま）

export OPENAI_API_KEY="YOUR_APIYI_KEY"
export OPENAI_BASE_URL="https://api.apiyi.com/v1"

メソッド呼び出し、パラメータ形式、レスポンス構造はすべて同一のままです。

基本

基本API

画像API（公式）

動画API（公式）

マルチモーダル理解API

テキストAPI

OpenAI Chat Completions 互換モード

クイックスタート

1つのインターフェース、すべてのプロバイダー

SDK の言語別セットアップ

Python

Node.js / TypeScript

.NET

Go

Java

共通機能

ストリーミング

推論の制御

画像入力

埋め込み

エラー処理と再試行

Compatibleモードの機能制限

OpenAI Direct からの移行

関連リンク

​クイックスタート

​1つのインターフェース、すべてのプロバイダー

​SDK の言語別セットアップ

​Python

​Node.js / TypeScript

​.NET

​Go

​Java

​共通機能

​ストリーミング

​推論の制御

​画像入力

​埋め込み

​エラー処理と再試行

​Compatibleモードの機能制限

​OpenAI Direct からの移行

​関連リンク

クイックスタート

1つのインターフェース、すべてのプロバイダー

SDK の言語別セットアップ

Python

Node.js / TypeScript

.NET

Go

Java

共通機能

ストリーミング

推論の制御

画像入力

埋め込み

エラー処理と再試行

Compatibleモードの機能制限

OpenAI Direct からの移行

関連リンク