LatticeHub
免费开始

文档中心

API 接入、图片生成、异步任务和常见错误的可运行示例。

快速开始

创建密钥，替换 Base URL，然后使用兼容 OpenAI 的客户端发起请求。

创建项目密钥

每个项目使用独立密钥，只在服务端保存，不要写入网页或公开仓库。

管理密钥

Base URL

https://api.latticehub.top/v1

OpenAI SDK 通常需要包含 /v1。直接请求接口时也使用这里展示的完整地址。

curl https://api.latticehub.top/v1/chat/completions \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "YOUR_MODEL",
    "messages": [{"role": "user", "content": "ping"}]
  }'
curl https://api.latticehub.top/v1/models \
  -H "Authorization: Bearer YOUR_API_KEY"

图片生成与编辑

使用 OpenAI Images 兼容接口生成图片；响应里优先读取 data[0].url，若返回 b64_json 则解码保存。

curl https://api.latticehub.top/v1/images/generations \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "YOUR_IMAGE_MODEL",
    "prompt": "A clean product photo on a dark stone surface",
    "size": "1024x1024"
  }'

异步任务

视频等耗时任务先提交再轮询：提交后拿到 task_id，按需查询状态，完成后读取结果。已提交的任务也会出现在控制台的“异步任务”里。

# 1. Submit
curl https://api.latticehub.top/v1/video/generations \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model": "YOUR_VIDEO_MODEL", "prompt": "A paper boat drifting on a pond"}'

# 2. Poll (task_id comes from step 1)
curl https://api.latticehub.top/v1/video/generations/TASK_ID \
  -H "Authorization: Bearer YOUR_API_KEY"

常见错误

  • 401：密钥无效、已删除或写错，请重新复制。
  • 403：密钥所属分组不能调用该模型，或被 IP 白名单拒绝。
  • 429：请求太频繁，请降低并发后重试。
  • 额度不足：充值或调高密钥额度上限。
  • 模型暂时不可用：请稍后重试，或换一个分组的密钥。