ULING19 DOCSAPI integration guide
OpenAI-compatible gateway

使用文档

从创建密钥到接入客户端，快速使用文本、工具调用、图片与向量能力。客户端只需要本站 API Key，不要填写任何上游账号凭据。

Base URLhttps://api-provider.uling19.com/v1
AuthorizationBearer sk-...
ProtocolOpenAI compatible
01

快速开始

  1. 1登录控制台，进入「API Keys / 密钥」创建自己的 API Key。
  2. 2在客户端填入 Base URL：https://api-provider.uling19.com/v1。
  3. 3填入本站创建的 sk-...，不要使用上游账号密钥。
  4. 4请求 GET /v1/models 获取实时模型，再发送低输出测试请求。
登录与注册启用了 Cloudflare Turnstile；已签发 API Key 的模型请求不需要重复做人机验证。
02

接口清单

GET/v1/models获取当前可见模型
POST/v1/chat/completions聊天、工具调用、流式输出
POST/v1/responsesResponses / Agent 工作流
POST/v1/images/generations文生图和图片编辑
POST/v1/embeddings1536 维文本向量
03

Chat Completions

cURL
curl https://api-provider.uling19.com/v1/chat/completions \
  -H 'Authorization: Bearer ***' \
  -H 'Content-Type: application/json' \
  -d '{
    "model": "gpt-5.6-sol",
    "messages": [{"role":"user","content":"只回复 OK"}],
    "stream": false
  }'
04

Responses API

cURL
curl https://api-provider.uling19.com/v1/responses \
  -H 'Authorization: Bearer ***' \
  -H 'Content-Type: application/json' \
  -d '{
    "model": "gpt-5.6-sol",
    "input": "只回复 OK"
  }'

适用于 Codex、Agent 和需要 Responses 协议的客户端。若客户端自动拼接 /responses，请按客户端说明决定 Base URL 是否保留 /v1。

05

图片生成

cURL
curl https://api-provider.uling19.com/v1/images/generations \
  -H 'Authorization: Bearer ***' \
  -H 'Content-Type: application/json' \
  -d '{
    "model": "gpt-image-2",
    "prompt": "低饱和蓝紫色未来城市，电影光影",
    "size": "1024x1024"
  }'
图片请求通常慢于文本请求。建议降低并发并设置充足超时，不要高频重复提交同一任务。
06

Embeddings

cURL
curl https://api-provider.uling19.com/v1/embeddings \
  -H 'Authorization: Bearer ***' \
  -H 'Content-Type: application/json' \
  -d '{
    "model": "text-embedding-3-small",
    "input": "用于语义检索的文本"
  }'
07

客户端配置

Hermes Agent

Base URL 填本站 /v1 地址；模型以控制台或 /v1/models 为准。

OpenClaw

使用 OpenAI-compatible provider，按客户端能力选择 Responses 或 Completions。

OpenCode / Codex

需要 Responses 的客户端可使用同一 API Key；不要把 provider/model 永久写死到会话。

ccswitch

Provider 名称可用 uling19；Base URL 避免多余尾斜杠。

通用参数

项目值
Provideruling19
Base URLhttps://api-provider.uling19.com/v1
API Key控制台生成的 sk-...
协议OpenAI-compatible
08

错误排查

状态建议
401检查 API Key 是否正确、启用且属于当前账户。
403检查模型权限、分组策略或上游风控；不要高频重试。
429降低并发并指数退避，等待额度或限流窗口恢复。
502 / 503 / 524通常是上游故障、超时或无可用账号；记录 request ID 后联系站长。

排障时请提供发生时间、模型、接口、HTTP 状态与 request ID，不要发送完整 API Key。

09

安全说明

  • 不要把 API Key 提交到 GitHub、网页前端、公开日志或截图。
  • 不要共享 Key；发现泄露应立即在控制台撤销并重建。
  • 自动化任务应设置合理并发、超时和退避，避免持续压测。
  • 模型、倍率和路由按实时可用性调整，以控制台与真实调用为准。