API 快速开始

API 快速开始

Base URL

所有 API 请求的 base URL 为:

https://api.123.com/v1

鉴权方式

所有请求需要在 HTTP 头中携带 API Key:

Authorization: Bearer sk-xxxxxxxxxxxx

在「控制台 → API Key」页面创建令牌后,会显示完整的 Key(仅显示一次,请妥善保存)。

第一个请求

curl

curl https://api.123.com/v1/chat/completions \
  -H "Authorization: Bearer sk-xxxx" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-4o",
    "messages": [
      {"role": "user", "content": "你好"}
    ]
  }'

Python

import requests

resp = requests.post(
    "https://api.123.com/v1/chat/completions",
    headers={
        "Authorization": "Bearer sk-xxxx",
        "Content-Type": "application/json",
    },
    json={
        "model": "gpt-4o",
        "messages": [
            {"role": "user", "content": "你好"}
        ],
    },
)
print(resp.json())

OpenAI SDK(Python)

平台 API 兼容 OpenAI SDK,只需修改 base_url:

from openai import OpenAI

client = OpenAI(
    api_key="sk-xxxx",
    base_url="https://api.123.com/v1",
)

resp = client.chat.completions.create(
    model="gpt-4o",
    messages=[{"role": "user", "content": "你好"}],
)
print(resp.choices[0].message.content)

OpenAI SDK(Node.js)

import OpenAI from "openai";

const client = new OpenAI({
    apiKey: "sk-xxxx",
    baseURL: "https://api.123.com/v1",
});

const resp = await client.chat.completions.create({
    model: "gpt-4o",
    messages: [{ role: "user", content: "你好" }],
});
console.log(resp.choices[0].message.content);

支持的接口

接口 路径 说明
对话补全 POST /v1/chat/completions 文本对话
文本嵌入 POST /v1/embeddings 向量嵌入
图片生成 POST /v1/images/generations 同步图片
异步图片 POST /v1/images/async 大图异步生成
模型列表 GET /v1/models 可用模型

额度说明

  • 每个令牌有独立的额度上限
  • 调用 API 时按模型定价扣除额度
  • 在「控制台 → API Key」可查看剩余额度

下一步