⚡ OpenAI 兼容 · 开箱即用

一行配置
接入 53 个 AI 模型

对话、图片、视频全系列模型，OpenAI 兼容协议直连。把 base_url 换成 unvstar.com/v1，你的现有代码、脚本、Agent 工具立刻可用——按站内同价扣积分，无需另付订阅。

立即获取 API Key 查看快速开始

1三步接入

1

注册并充值

注册送 10 积分体验金。微信 / 支付宝扫码充值，1 元 = 10 积分，多充多送。

2

生成 API Key

用户中心 →「API 密钥」→ 创建密钥。Key 以 sk-fx- 开头，明文仅展示一次，请立即保存。每人最多 5 把。

3

配置 base_url

把任何 OpenAI 兼容工具的接口地址换成 https://unvstar.com/v1，填入 Key 即可开始调用。

💡
兼容工具：OpenAI Python / Node SDK、curl、WorkBuddy、Codex、Dify、FastGPT、One-API、ChatBox 等一切支持自定义 OpenAI 接口地址的工具均可直连。

2接口地址与认证

项目说明
Base URLhttps://unvstar.com/v1
认证方式请求头 Authorization: Bearer sk-fx-你的密钥（OpenAI 标准 Bearer 认证）
模型列表GET /v1/models 返回全部模型及价格元数据，可直接编程选型
计费与站内网页版同价，按次 / 按张 / 按秒扣积分，失败自动全额退回

3端点总览

端点说明
GET/v1/models模型列表（对话 / 图片 / 视频，含每个模型的积分价格）
POST/v1/chat/completions对话补全，支持 stream 流式输出与 tools 透传
POST/v1/images/generations图片生成，支持 OpenAI 标准 size 或原生 resolution / ratio
POST/v1/videos创建视频任务（异步），完成后轮询取结果；兼容 /v1/video/generations 别名
GET/v1/videos/{id}查询视频任务状态，成功后返回 url / download_url
POST/v1/uploads上传参考图（multipart 文件字段 file），返回临时 URL，供图生视频使用

4对话 · Chat Completions

与 OpenAI 协议完全一致，改 base_url 即可迁移。支持流式（stream: true，SSE 格式）。

Python · OpenAI SDK
from openai import OpenAI

client = OpenAI(
    api_key="sk-fx-你的密钥",
    base_url="https://unvstar.com/v1",  # 只需改这一行
)

resp = client.chat.completions.create(
    model="gemini-3-pro",
    messages=[{"role": "user", "content": "用一句话介绍你的业务"}],
)
print(resp.choices[0].message.content)
curl · 流式输出
curl https://unvstar.com/v1/chat/completions \
  -H "Authorization: Bearer sk-fx-你的密钥" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gemini-3-pro",
    "messages": [{"role": "user", "content": "写一条电商带货视频的开场钩子"}],
    "stream": true
  }'

5图片生成 · Images

OpenAI 标准参数直接可用：size（如 1024x1024）会自动换算为对应分辨率与比例；也可以直接传 resolution + ratio。响应含图片直链与本次消耗积分。

curl · 文生图
curl https://unvstar.com/v1/images/generations \
  -H "Authorization: Bearer sk-fx-你的密钥" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "nano-banana-2",
    "prompt": "白底产品图：一只白色保温杯，商业摄影质感，柔和打光",
    "size": "1024x1024",
    "n": 1
  }'
响应示例
{
  "created": 1740739200,
  "data": [{ "url": "https://unvstar.com/uploads/image/img_123_0.png", "object": "image" }],
  "usage": { "credits": 2.5, "balance": 997.5 }
}
⏳
注意：生成的图片会转存到本站服务器长期保留，url 可放心持久化引用。

6视频生成 · Videos（异步）

提交任务立即返回任务 ID（vid_ 前缀），之后轮询查询；状态变为 completed 后取 url。失败任务积分全额自动退回。

① 创建任务（文生视频）
curl https://unvstar.com/v1/videos \
  -H "Authorization: Bearer sk-fx-你的密钥" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "lec-gt-seedance-2-0-mini",
    "prompt": "竖屏视频：白人女主手持产品对镜头微笑讲解，客厅场景，自然光",
    "duration": 15,
    "resolution": "720p",
    "aspect_ratio": "9:16"
  }'
② 上传参考图（图生视频用，可选）
curl https://unvstar.com/v1/uploads \
  -H "Authorization: Bearer sk-fx-你的密钥" \
  -F "file=@product.jpg"
# 返回 {"url": "https://...", "expires_in": 1800}
# 把返回的 url 放进创建任务请求的 "image_urls": ["https://..."]，最多 4 张
③ 轮询任务状态
curl https://unvstar.com/v1/videos/vid_123 \
  -H "Authorization: Bearer sk-fx-你的密钥"
字段说明
statusin_progress（生成中）/ completed（完成）/ failed（失败，积分已退回）
progressin_progress 时返回 {"percent": 1-100, "stage": "合成中"} 实时进度，可用于渲染进度条
url / download_url视频直链（completed 后返回），可直接下载或分发
credits_cost实际结算积分（completed 后返回）
credits_reserved创建时按所选模型预扣的积分，成功即最终价，失败全额退
errorfailed 时返回失败原因
💡
参考图有效期 30 分钟：上传返回的临时 URL 请尽快用于创建视频任务；任务创建时会预检参考图可达性，失效会立即返回 4xx 而不是提交后失败。视频通常 2~15 分钟完成，建议每 10~20 秒轮询一次。

7计费与使用限制

项目规则
计费口径与站内网页版完全一致：同一模型、同一档位、同一价格，积分向上取整
充值比例1 元 = 10 积分（充值多送，见充值中心）
失败退款生成失败自动全额退回积分，无需申请
余额预检余额不足时返回 402，视频任务按所选模型预扣、成功结算、失败退款
频率限制每 Key 60 次 / 分钟；视频并发任务 ≤ 3（超出返回 429）
Key 数量每账号 5 把，可随时在用户中心吊销重建

8常见问题

Q：报错「模型不存在」？
模型名需与 GET /v1/models 返回的完全一致（区分大小写）。完整模型列表以该接口为准。

Q：视频任务返回 402 / 余额不足？
视频按所选模型预扣积分（按秒计费模型 = 单价 × 时长）。请先确认余额充足再提交，充值即时到账。

Q：图片 URL 能长期保存吗？
可以。成品图和视频都转存在本站服务器，直链长期有效。

Q：支持开发票吗？
企业客户可联系客服开具发票、对公转账充值，量大可议渠道价格。