API 文档

统一响应格式

成功响应:

{
  "data": [...],
  "message": "success"
}

失败响应:

{
  "error": {
    "code": 401,
    "message": "Invalid API key"
  }
}

GET /user.php

获取当前用户的使用情况

curl 示例:

curl -X GET https://bytesite.xiaojiaixhs.com/user.php \
  -H "Authorization: Bearer YOUR_API_KEY"

响应示例:

{
  "name": "用户名",
  "daily_limit": 100,
  "daily_used": 25,
  "monthly_limit": 3000,
  "monthly_used": 500,
  "expires_at": "2026-12-31"
}

POST /v1/images/generations

生成图片

支持的模型:

请求参数（即梦系列）:

{
  "model": "jimeng-4.5",
  "prompt": "图片描述",
  "ratio": "1:1",
  "resolution": "1k"
}

请求参数（image2）:

{
  "model": "image2",
  "prompt": "图片描述",
  "size": "1024x1024",
  "response_format": "url"
}

size 可选：1024x1024（方形）、1024x1792（竖屏）、1792x1024（横屏）；response_format 可选 url 或 b64_json，默认 b64_json。

curl 示例（即梦）:

curl -X POST https://bytesite.xiaojiaixhs.com/v1/images/generations \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "jimeng-4.5",
    "prompt": "一只可爱的猫咪坐在窗边",
    "ratio": "1:1",
    "resolution": "1k"
  }'

curl 示例（image2）:

curl -X POST https://bytesite.xiaojiaixhs.com/v1/images/generations \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "image2",
    "prompt": "一只可爱的猫咪坐在窗边",
    "size": "1024x1024",
    "response_format": "url"
  }'

POST /v1/videos/generations

生成视频

支持的模型:

请求参数:

{
  "model": "jimeng-video-3.5-pro",
  "prompt": "视频描述",
  "duration": 5,
  "ratio": "16:9",
  "resolution": "720p"
}

curl 示例:

curl -X POST https://bytesite.xiaojiaixhs.com/v1/videos/generations \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "jimeng-video-3.5-pro",
    "prompt": "一只猫咪在草地上奔跑",
    "duration": 5,
    "ratio": "16:9",
    "resolution": "720p"
  }'

POST /v1/images/compositions

图片合成接口，支持多图融合、风格迁移等高级图像处理

请求参数示例:

{
  "model": "jimeng-4.5",
  "prompt": "将两张图片融合成一张",
  "images": [
    "https://example.com/image1.jpg",
    "https://example.com/image2.jpg"
  ],
  "composition_mode": "blend",
  "ratio": "16:9",
  "resolution": "2k"
}

参数说明:

curl 示例:

curl -X POST https://bytesite.xiaojiaixhs.com/v1/images/compositions \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "jimeng-4.5",
    "prompt": "将两张图片融合成一张艺术作品",
    "images": [
      "https://example.com/image1.jpg",
      "https://example.com/image2.jpg"
    ],
    "composition_mode": "blend",
    "ratio": "16:9",
    "resolution": "2k"
  }'

分辨率支持

图片分辨率:

视频分辨率:

参数详细说明

错误码说明

错误响应示例:

{
  "error": {
    "code": 403,
    "message": "Daily quota exceeded"
  }
}

POST /v1/images/edits

基于参考图生成新图片

请求参数:

{
  "model": "jimeng-4.5",
  "prompt": "将这只猫咪变成卡通风格",
  "image": "https://example.com/cat.jpg",
  "ratio": "1:1",
  "resolution": "2k",
  "strength": 0.7
}

参数说明:

curl示例:

curl -X POST https://bytesite.xiaojiaixhs.com/v1/images/edits \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "jimeng-4.5",
    "prompt": "将这只猫咪变成卡通风格",
    "image": "https://example.com/cat.jpg",
    "ratio": "1:1",
    "resolution": "2k",
    "strength": 0.7
  }'

POST /v1/videos/seedance

Seedance舞蹈视频生成（图片驱动人物跳舞）

请求参数:

{
  "model": "jimeng-video-seedance-2.0",
  "image": "https://example.com/person.jpg",
  "dance_video": "https://example.com/dance.mp4",
  "resolution": "720p"
}

参数说明:

⚠️ 重要说明:

Seedance 模型需要使用 multipart/form-data 格式上传文件，不支持 JSON 格式。

Seedance 2.0 多图视频示例:

curl -X POST https://bytesite.xiaojiaixhs.com/v1/videos/generations \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -F "model=jimeng-video-seedance-2.0" \
  -F "prompt=@1 和 @2 两人开始跳舞" \
  -F "ratio=4:3" \
  -F "duration=4" \
  -F "files=@/path/to/image1.jpg" \
  -F "files=@/path/to/image2.jpg"

Seedance 2.0-fast 快速视频示例:

curl -X POST https://bytesite.xiaojiaixhs.com/v1/videos/generations \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -F "model=jimeng-video-seedance-2.0-fast" \
  -F "prompt=@1 图片中的人物开始微笑" \
  -F "ratio=4:3" \
  -F "duration=5" \
  -F "files=@/path/to/image1.jpg"

GET /v1/models

获取可用模型列表

curl示例:

curl -X GET https://bytesite.xiaojiaixhs.com/v1/models \
  -H "Authorization: Bearer YOUR_API_KEY"

响应示例:

{
  "data": [
    {"id": "jimeng-4.5", "type": "image"},
    {"id": "jimeng-video-3.5-pro", "type": "video"}
  ]
}