快速开始

接口地址是 https://api.optimal-api.com/v1。

请求体沿用 OpenAI 的对话格式。密钥放在 Authorization: Bearer 后面。请先在控制台创建密钥，并在第一次付费调用前充值。

curl

curl https://api.optimal-api.com/v1/chat/completions \
  -H "Authorization: Bearer $OPTIMAL_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model":"auto","messages":[{"role":"user","content":"Hello"}]}'

curl，指定模型

curl https://api.optimal-api.com/v1/chat/completions \
  -H "Authorization: Bearer $OPTIMAL_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model":"gpt-4o-mini","messages":[{"role":"user","content":"Hello"}]}'

curl，列出模型

curl https://api.optimal-api.com/v1/models \
  -H "Authorization: Bearer $OPTIMAL_API_KEY"

Python

import json
import os
import urllib.request

request = urllib.request.Request(
    "https://api.optimal-api.com/v1/chat/completions",
    data=json.dumps({
        "model": "auto",
        "messages": [{"role": "user", "content": "Hello"}],
    }).encode(),
    headers={
        "Authorization": "Bearer " + os.environ["OPTIMAL_API_KEY"],
        "Content-Type": "application/json",
    },
)
with urllib.request.urlopen(request) as response:
    body = json.load(response)
print(body["choices"][0]["message"]["content"])

Python，OpenAI SDK

from openai import OpenAI

client = OpenAI(
    api_key="YOUR_API_KEY",
    base_url="https://api.optimal-api.com/v1",
)
result = client.chat.completions.create(
    model="auto",
    messages=[{"role": "user", "content": "Hello"}],
)
print(result.choices[0].message.content)

Node.js

const response = await fetch("https://api.optimal-api.com/v1/chat/completions", {
  method: "POST",
  headers: {
    Authorization: `Bearer ${process.env.OPTIMAL_API_KEY}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    model: "auto",
    messages: [{ role: "user", content: "Hello" }],
  }),
});
const body = await response.json();
if (!response.ok) {
  console.error(body);
  process.exit(1);
}
console.log(body.choices[0].message.content);

Node.js，OpenAI SDK

import OpenAI from "openai";

const client = new OpenAI({
  apiKey: process.env.OPTIMAL_API_KEY,
  baseURL: "https://api.optimal-api.com/v1",
});
const result = await client.chat.completions.create({
  model: "auto",
  messages: [{ role: "user", content: "Hello" }],
});
console.log(result.choices[0].message.content);

Python 标准库示例不需要额外安装包。SDK 示例需要 openai 包，并把 YOUR_API_KEY 换成真实密钥。
Node 示例使用当前 Node 自带的 fetch。SDK 示例需要 openai 包。
model 可以是 auto、auto:cheap、auto:balanced、auto:best，或模型页上的名字。
非流式的 auto 响应带有 x-routed-model。x-estimated-savings-micros 用估算基线比较实际价格。

想要一步一步的图解？打开入门教程

接口状态