星空

快速开始

  1. 注册
  2. 充值人民币
  3. 创建 Key,明文只出现一次
  4. 把 Base URL 设成下面这个地址

Base URL

https://api.yuanxingspace.com/v1

调用示例

curl https://api.yuanxingspace.com/v1/chat/completions \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model":"deepseek-v4.1-flash","messages":[{"role":"user","content":"hello"}]}'

错误码

code 是稳定英文,不随语言改变。调用方只认 code。

Chat 和异步任务只使用这些 code。message 随语言变化,code 不翻译。

Chat

生成一段文本回复。

POST https://api.yuanxingspace.com/v1/chat/completions

请求体需要 model 和 messages。每条 message 的 role 是 system、user 或 assistant。可以附加 stream、temperature 和 max_tokens。

stream 为 true 时,响应是 text/event-stream,事件形状是 OpenAI 的 chat.completion.chunk。

curl https://api.yuanxingspace.com/v1/chat/completions \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model":"deepseek-v4.1-flash","messages":[{"role":"user","content":"hello"}]}'

异步任务

图片、视频、音频走异步任务:先提交,拿到任务 id,再查状态;成功后用 result_url 下载结果。

模型和计费

model类型怎么计费
seedream-5.5seedream-5.0-pro图片按张。输出图不超过 2.61MP(比如 1K、1600x1600)是一档,更大(比如默认的 2K)是另一档;每张参考图另收(5.0 Pro 第一张参考图免费)。一个任务出一张图。
seedance-2.0seedance-2.5视频按视频 token,以火山返回的实际用量为准。按分辨率(480p 和 720p、1080p、4K)和有没有参考视频分档。

视频 token 约等于 宽 × 高 × 帧率 × 秒数 ÷ 1024。16:9、24 帧时每秒约:480p 9,700,720p 21,600,1080p 48,600,4K 194,400。

各档价格见首页。

调用示例

POST https://api.yuanxingspace.com/v1/jobs

请求体需要 model 和 modality。modality 是 image、video、audio 或 3d。input 是这一次的参数,不会写入用量流水。

input 就是火山接口的请求体,字段名和火山文档一致;model 不用写在 input 里。参考图、参考视频、参考音频请给 URL,请求体最大 1 MiB。

图片(Seedream)

curl https://api.yuanxingspace.com/v1/jobs \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model":"seedream-5.5","modality":"image","input":{"prompt":"一只在雪地里奔跑的柴犬","size":"2K","watermark":false}}'

视频(Seedance),duration 必填

curl https://api.yuanxingspace.com/v1/jobs \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model":"seedance-2.0","modality":"video","input":{"content":[{"type":"text","text":"柴犬在雪地里奔跑,镜头跟随"}],"duration":5,"resolution":"720p","ratio":"16:9"}}'

任务被接受时返回 202 和 id。

GET https://api.yuanxingspace.com/v1/jobs

GET https://api.yuanxingspace.com/v1/jobs/{id}

GET /v1/jobs 列出当前调用方的任务。GET /v1/jobs/{id} 读取一个任务。这两个接口只读,不会冻结或扣费。

status 是 queued、running、succeeded、failed 或 cancelled。

curl https://api.yuanxingspace.com/v1/jobs \
  -H "Authorization: Bearer YOUR_API_KEY"
curl https://api.yuanxingspace.com/v1/jobs/job_1 \
  -H "Authorization: Bearer YOUR_API_KEY"

冻结和扣费

提交时按这一次最多可能花的钱冻结余额:图片按大图档加参考图;视频按“时长 × 这个分辨率每秒 token 的上限”(每段参考视频按 15 秒算,duration 为 -1 按 30 秒算);音频按 120 秒。任务成功后按实际用量扣费,多冻结的马上退回。余额不够冻结时返回 402 insufficient_quota。

任务失败、内容审核不通过、超时都不扣费,冻结全部退回,错误码是 upstream_unavailable。

不支持的参数

下面这些提交时直接返回 400 invalid_request,不冻结:一次出多张图(n 不是 1、组图 sequential_image_generation、图层拆分 layer_decomposition)和 stream;视频没写 duration、duration 不在 1–30 秒(-1 表示让模型决定)、resolution 不是 480p、720p、1080p、4k,以及 draft、return_last_frame、callback_url、frames、service_tier、tools;音频超过 3000 字、enable_subtitle。

结果和通知

succeeded 的响应带 result_url:签名下载链接,15 分钟内有效,过期后再读一次任务就有新链接。结果文件保存 7 天,到期自动删除,请及时下载。

提交时可以带 webhook_url:任务结束时我们向它 POST 一次 JSON,里面有任务 id、状态和结果链接。收到后请用 GET /v1/jobs/{id} 再确认一次。

登录网站后,“任务”页能看到最近 50 个任务,可以预览和下载结果。