SOOLINK 开发者文档

使用一个统一接口接入对话、图像、音频、视频和向量模型。

基础地址
https://soolink.ai/v1

快速开始

创建 API 令牌后,将基础地址和令牌交给兼容 OpenAI SDK 的客户端即可开始调用。

发送第一个请求

curl
curl https://soolink.ai/v1/chat/completions \
  -H "Authorization: Bearer $SOOLINK_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "your-model",
    "messages": [{"role": "user", "content": "Hello"}]
  }'

JavaScript SDK

javascript
import OpenAI from 'openai'

const client = new OpenAI({
  apiKey: process.env.SOOLINK_API_KEY,
  baseURL: 'https://soolink.ai/v1',
})

const response = await client.chat.completions.create({
  model: 'your-model',
  messages: [{ role: 'user', content: 'Hello' }],
})

身份验证

所有模型请求都使用 Bearer Token。请只在服务端保存令牌,不要写入浏览器代码或公开仓库。

Authorization: Bearer sk-soolink-••••••••

接口目录

实际可用模型取决于账号分组和当前已启用线路。先请求模型列表,再使用返回的模型名称。

GETGET /v1/models获取当前令牌可用的模型列表
POSTPOST /v1/chat/completionsOpenAI 兼容的对话补全
POSTPOST /v1/messagesAnthropic Messages 兼容接口
POSTPOST /v1/embeddings生成文本向量
POSTPOST /v1/images/generations生成图像
POSTPOST /v1/audio/speech文本转语音
POSTPOST /v1/video/generations提交异步视频生成任务
POSTPOST /v1/rerank对候选文档重排序

错误处理

HTTP 状态码表示请求结果。错误响应中的 message 可用于诊断,但不要向最终用户暴露上游凭据或内部配置。

400检查参数和模型名称
401检查 API 令牌
429退避后重试
500+记录请求 ID 后重试

下一步

进入控制台创建 API 令牌,然后从模型列表确认可调用名称。

打开控制台