API 接口文档

简介

时空API 是一个 AI 模型 API 聚合平台，提供 GPT Image、Gemini、Veo3 等主流 AI 模型的接口服务。 本文档面向下游开发者，描述如何通过 API Key 调用我们的接口，请求会自动转发到上游模型提供商。

访问域名：https://aishikong.top、https://www.aishikong.top（两者等效）；API 前缀为 /api/v1，OpenAI 兼容前缀为 /v1。

认证方式

所有 API 请求都需要在 HTTP 头中携带 API Key 进行认证：

# 请求头格式
Authorization: Bearer sk-grsai-xxxxxxxxxxxxxxxxxxxxxxxx

获取 API Key 步骤：

1. 1. 注册 时空API 账号（注册即送 5000 积分）
2. 2. 登录控制台，进入「API 密钥」页面
3. 3. 点击「创建密钥」，生成 sk-grsai-xxx 格式的密钥
4. 4. 在请求头中使用该密钥调用 API

基础信息

文本模型

文本模型通过 /api/v1/chat/completions 端点调用，按 token 计费。

调用模型示例

所有模型共用同一套接口与 API Key，调用时只需修改 model 参数。模型 ID 可通过下方速查表、模型列表 或 GET /api/v1/models 获取，必须与返回的 id 完全一致。

常用模型速查

1. 文本模型调用

与 OpenAI Chat Completions 完全兼容，支持 stream、temperature、max_tokens 等参数。

# cURL：调用 GPT-5.5
curl -X POST https://aishikong.top/api/v1/chat/completions \
  -H "Authorization: Bearer sk-grsai-xxx" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-5.5",
    "messages": [
      { "role": "user", "content": "你好，请用一句话介绍你自己" }
    ],
    "temperature": 0.7,
    "max_tokens": 512
  }'

其他文本模型只需替换 model，例如 gemini-3.5-flash、gemini-3.1-pro、claude-sonnet-5、claude-opus-4-8。

2. 图片模型调用（文生图）

OpenAI Images API 兼容格式，size 支持 1024x1024、2048x2048、4096x4096 等像素格式，也支持 1K/2K/4K 档位。

# cURL：标准尺寸文生图
curl -X POST https://aishikong.top/api/v1/images/generations \
  -H "Authorization: Bearer sk-grsai-xxx" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-image-2",
    "prompt": "一只戴墨镜的橘猫，电影感光影，背景虚化",
    "size": "1024x1024",
    "n": 1,
    "response_format": "url"
  }'

# cURL：4K 直出（长边 4096px）
curl -X POST https://aishikong.top/api/v1/images/generations \
  -H "Authorization: Bearer sk-grsai-xxx" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "nano-banana-2-4k-cl",
    "prompt": "雪山湖泊，超高清细节",
    "size": "4096x4096",
    "response_format": "url"
  }'

返回 data[0].url 即可直接下载；也可用 /api/v1/generate 配合 aspectRatio 与 imageSize: "4K" 指定比例和分辨率。

3. 图片模型调用（图生图）

通过 images 传入参考图 URL 数组（公网可访问地址），需使用异步接口 /api/v1/generate。

curl -X POST https://aishikong.top/api/v1/generate \
  -H "Authorization: Bearer sk-grsai-xxx" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "nano-banana-pro-vip",
    "prompt": "保持人物不变，把背景换成海边日落",
    "images": ["https://example.com/input.jpg"],
    "aspectRatio": "1:1",
    "imageSize": "2K"
  }'

异步接口返回 data.id 任务 ID，通过 查询异步结果 接口轮询获取图片地址。

4. 视频模型调用

视频模型使用 /api/v1/generate，额外支持 resolution（分辨率）、duration（时长，秒）、aspectRatio（画面比例）参数。

curl -X POST https://aishikong.top/api/v1/generate \
  -H "Authorization: Bearer sk-grsai-xxx" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "minimax-h3-wuwu",
    "prompt": "夕阳下的海浪拍打礁石，镜头缓慢推进",
    "aspectRatio": "16:9",
    "resolution": "1080p",
    "duration": 8
  }'

同样返回任务 ID，轮询 /api/v1/result?id={task_id} 获取视频地址。

部分视频模型（如 seedance-2.5、minimax-h3、kling-video-v4）支持参考图/多模态输入：通过 images 传入参考图 URL 数组（最多 9 张），部分模型还支持参考视频与音频输入，可实现图生视频、产品展示视频等效果。

curl -X POST https://aishikong.top/api/v1/generate \
  -H "Authorization: Bearer sk-grsai-xxx" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "minimax-h3-wuwu",
    "prompt": "模特转身展示裙型，裙摆自然飘动，产品特写",
    "images": ["https://example.com/product.jpg"],
    "resolution": "1080p",
    "duration": 10
  }'

参考图生视频（图生视频）支持上传产品图/模特图，由模型保持主体不变并生成动态展示视频，适合电商产品宣传。

完整 Python 调用示例（提交 + 轮询 + 下载）：

# Python 3.7+，依赖 requests
import time
import requests

API_BASE = "https://aishikong.top"
API_KEY = "sk-grsai-xxx"  # 替换为你的 API Key
headers = {"Authorization": f"Bearer {API_KEY}", "Content-Type": "application/json"}

# ===== 第一步：提交任务（参考图生视频）=====
submit_body = {
    "model": "minimax-h3-wuwu",
    "prompt": "模特在纯白影棚中转身展示裙装，裙摆自然飘动，缓慢推进镜头，电商展示风格",
    "images": ["https://example.com/product.jpg"],  # 参考图（产品图/模特图），最多9张，单张≤10MB
    "resolution": "1080p",   # 720p / 1080p / 2K
    "duration": 10,            # 4-15 秒
    "aspectRatio": "9:16"   # 9:16 竖版（电商短视频）或 16:9
}

resp = requests.post(f"{API_BASE}/api/v1/generate", json=submit_body, headers=headers, timeout=600)
data = resp.json()
print("提交结果:", data)

task_id = data.get("id")
if not task_id:
    print("提交失败:", data)
    exit(1)

# ===== 第二步：轮询任务状态 =====
while True:
    r = requests.get(f"{API_BASE}/api/v1/result", params={"id": task_id}, headers=headers, timeout=60)
    result = r.json()
    print("轮询:", result)

    status = result.get("status") or result.get("data", {}).get("status")
    if status == "succeeded":
        # 兼容两种返回结构
        results = result.get("results") or result.get("data", {}).get("results") or []
        video_url = results[0]["url"] if results else ""
        print("生成成功，视频地址:", video_url)
        break
    elif status in ("failed", "cancelled"):
        print("生成失败:", result.get("error") or result.get("message"))
        break
    else:
        time.sleep(5)  # 建议 5 秒轮询一次，视频生成需 3-7 分钟

# ===== 第三步（可选）：下载视频到本地 =====
# with open("output.mp4", "wb") as f:
#     f.write(requests.get(video_url).content)

/api/v1/generate 若任务完成会直接返回 results[].url；视频任务提交后立即返回 status: processing 与任务 ID，用 /api/v1/result?id={task_id} 轮询直至成功，返回体中的 progress（0-100）为生成进度。

5. OpenAI SDK 直接接入

将 base_url 换成 https://aishikong.top/v1 即可，无需修改业务代码。备用域名 https://www.aishikong.top/v1 同样可用。

# Python (openai>=1.0)
from openai import OpenAI

client = OpenAI(
    api_key="sk-grsai-xxx",
    base_url="https://aishikong.top/v1"
)

# 文本模型
resp = client.chat.completions.create(
    model="gemini-3.5-flash",
    messages=[{"role": "user", "content": "你好"}]
)
print(resp.choices[0].message.content)

# 图片模型
img = client.images.generate(
    model="gpt-image-2",
    prompt="一只戴墨镜的橘猫",
    size="1024x1024"
)
print(img.data[0].url)

// Node.js (openai>=4.0)
import OpenAI from "openai";

const client = new OpenAI({
  apiKey: "sk-grsai-xxx",
  baseURL: "https://aishikong.top/v1"
});

const resp = await client.chat.completions.create({
  model: "claude-sonnet-5",
  messages: [{ role: "user", content: "你好" }]
});
console.log(resp.choices[0].message.content);

6. 异步任务轮询（图片/视频）

curl -X GET "https://aishikong.top/api/v1/result?id=task-abc123" \
  -H "Authorization: Bearer sk-grsai-xxx"

{
  "code": 0,
  "data": {
    "id": "task-abc123",
    "status": "succeeded",
    "results": [
      { "url": "https://aishikong.top/temp-images/example.jpg" }
    ]
  }
}

建议每 2–3 秒轮询一次；status 为 succeeded 时从 data.results[].url 取结果，失败时查看 error 字段。

错误码

代码示例

import requests

resp = requests.post(
    "https://aishikong.top/api/v1/generate",
    headers={
        "Authorization": "Bearer sk-grsai-xxx",
        "Content-Type": "application/json"
    },
    json={
        "model": "gpt-image-2-vip",
        "prompt": "A cute cat",
        "aspectRatio": "1:1"
    }
)
data = resp.json()
print(data["data"]["results"][0]["url"])

const resp = await fetch("https://aishikong.top/api/v1/generate", {
  method: "POST",
  headers: {
    "Authorization": "Bearer sk-grsai-xxx",
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    model: "gpt-image-2-vip",
    prompt: "A cute cat",
    aspectRatio: "1:1"
  })
});
const data = await resp.json();
console.log(data.data.results[0].url);