API 开发文档

快速集成指南与完整 API 参考

文本 / 多模态接口

POST/v1/chat/completions

最推荐先测试的统一接口

文本和多模态统一走该接口。无论你是做普通对话、文本生成，还是带图片输入的多模态理解，都可以从这里开始。

/v1/chat/completions 遵循 OpenAI Chat Completions 兼容请求 / 响应结构，包括 model、messages、stream 等核心字段。OpenAI Responses 与 Anthropic Messages 兼容格式将在后续版本中支持。

如果你是第一次接入，建议先用最简单的文本消息验证成功，再继续测试图片输入、长上下文或流式输出。

请求方法

POST /v1/chat/completions

最常见用途

对话、写作、问答、文本生成、多模态理解

推荐首测方式

先发一条普通文本消息确认接口可用

什么时候应该先用这个接口

做文本能力时

如果你的目标是聊天、写作、翻译、总结、问答或内容生成，通常先从这个接口开始。

做多模态理解时

如果模型支持图片输入，仍然通过 messages 传内容，只是内容中会包含图片对象。

做首次联调时

这是最容易验证成功的接口，适合先确认 API Key、Base URL 和模型 ID 都正确。

CURL 示例

CURL

curl https://api.wei.run/v1/chat/completions \
  -H "Authorization: Bearer sk-xxxxxxxxxxxxxxxxxx" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "YOUR_MODEL_ID",
    "messages": [
      {"role": "user", "content": "Hello"}
    ],
    "stream": false
  }'

Python SDK 示例

python

from openai import OpenAI

client = OpenAI(
    api_key="sk-your-api-key",
    base_url="https://api.wei.run/v1",
)

response = client.chat.completions.create(
    model="YOUR_MODEL_ID",
    messages=[{"role": "user", "content": "Hello"}],
)

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

Node.js SDK 示例

typescript

import OpenAI from "openai";

const client = new OpenAI({
  apiKey: "sk-your-api-key",
  baseURL: "https://api.wei.run/v1",
});

const response = await client.chat.completions.create({
  model: "YOUR_MODEL_ID",
  messages: [{ role: "user", content: "Hello" }],
});

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

使用时请注意

model 字段必须填写当前平台真实可用的模型 ID，不能只写厂商名或能力标签。
普通文本请求最容易调试。等文本调用成功后，再继续测试图片输入或 stream 等高级能力。
如果接口返回模型内容，说明基础接入已经成功；若报 401 或 404，优先检查 API Key 和模型 ID。