API 文档

Base URL: https://bytesite.xiaojiaixhs.com
认证: 在请求头中添加 Authorization: Bearer YOUR_API_KEY

统一响应格式

成功响应:
{
  "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

生成图片

支持的模型:
模型ID 模型名称 说明
jiguang-5.0极光5.0最新版本,推荐使用
jiguang-4.6极光4.6稳定版本
jiguang-4.5极光4.5经典版本
jiguang-4.0极光4.0基础版本
jiguang-3.5极光3.5轻量版本
jiguang-3.0极光3.0快速生成
jiguang-2.5极光2.5标准版本
jiguang-2.0极光2.0通用版本
jiguang-1.5极光1.5入门版本
jiguang-1.0极光1.0初代版本
jiguang-lite极光轻量版快速预览
jiguang-pro极光专业版高质量输出
请求参数:
{
  "model": "jiguang-5.0",
  "prompt": "图片描述",
  "ratio": "1:1",
  "resolution": "1k"
}
curl 示例:
curl -X POST https://bytesite.xiaojiaixhs.com/v1/images/generations \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "jiguang-5.0",
    "prompt": "一只可爱的猫咪坐在窗边",
    "ratio": "1:1",
    "resolution": "1k"
  }'

POST /v1/videos/generations

生成视频

支持的模型:
模型ID 模型名称 说明
jiguang-video-3.5-pro极光视频3.5 Pro最新专业版,推荐使用
jiguang-video-3.5极光视频3.5标准版本
jiguang-video-3.0极光视频3.0稳定版本
jiguang-video-2.5极光视频2.5通用版本
jiguang-video-2.0极光视频2.0经典版本
jiguang-video-seedance-2.0Seedance 2.0舞蹈动作专用
jiguang-video-seedance-1.5Seedance 1.5舞蹈动作
jiguang-video-lite极光视频轻量版快速生成
jiguang-video-hd极光视频高清版高清输出
jiguang-video-4k极光视频4K版超高清输出
请求参数:
{
  "model": "jiguang-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": "jiguang-video-3.5-pro",
    "prompt": "一只猫咪在草地上奔跑",
    "duration": 5,
    "ratio": "16:9",
    "resolution": "720p"
  }'

POST /v1/images/compositions

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

请求参数示例:
{
  "model": "jiguang-5.0",
  "prompt": "将两张图片融合成一张",
  "images": [
    "https://example.com/image1.jpg",
    "https://example.com/image2.jpg"
  ],
  "composition_mode": "blend",
  "ratio": "16:9",
  "resolution": "2k"
}
参数说明:
参数 类型 必填 说明
modelstring使用的模型ID
promptstring合成描述
imagesarray图片URL数组(2-4张)
composition_modestring合成模式:blend(融合)、style(风格迁移)、merge(拼接),默认blend
ratiostring输出比例,默认1:1
resolutionstring输出分辨率,默认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": "jiguang-5.0",
    "prompt": "将两张图片融合成一张艺术作品",
    "images": [
      "https://example.com/image1.jpg",
      "https://example.com/image2.jpg"
    ],
    "composition_mode": "blend",
    "ratio": "16:9",
    "resolution": "2k"
  }'

分辨率支持

图片分辨率:
比例 1k 2k 4k
1:11024×10242048×20484096×4096
16:91024×5762048×11524096×2304
9:16576×10241152×20482304×4096
4:31024×7682048×15364096×3072
3:4768×10241536×20483072×4096
视频分辨率:
分辨率 尺寸 说明
480p854×480标清
720p1280×720高清(推荐)
1080p1920×1080全高清
2k2560×14402K超清
4k3840×21604K超高清

参数详细说明

错误码说明

参数 类型 必填 说明 示例值
错误码 说明 解决方案
401API Key无效或未提供检查Authorization头是否正确
403权限不足或额度已用完检查账户额度或升级套餐
404请求的资源不存在检查API端点路径是否正确
429请求过于频繁降低请求频率或稍后重试
500服务器内部错误稍后重试或联系技术支持
错误响应示例:
{
  "error": {
    "code": 403,
    "message": "Daily quota exceeded"
  }
}
modelstring是模型IDjiguang-5.0 promptstring是生成描述(中英文均可)一只可爱的猫咪 ratiostring否图片比例,默认1:11:1, 16:9, 9:16, 4:3, 3:4 resolutionstring否分辨率,默认1k1k, 2k, 4k, 720p, 1080p durationnumber否视频时长(秒),默认55, 10, 15 seednumber否随机种子,固定生成结果12345 nnumber否生成数量,默认11, 2, 3, 4

POST /v1/images/edits

基于参考图生成新图片

请求参数:
{
  "model": "jiguang-5.0",
  "prompt": "将这只猫咪变成卡通风格",
  "image": "https://example.com/cat.jpg",
  "ratio": "1:1",
  "resolution": "2k",
  "strength": 0.7
}
参数说明:
参数 类型 必填 说明
imagestring参考图片URL或base64
strengthnumber变化强度 0.1-1.0,默认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": "jiguang-5.0",
    "prompt": "将这只猫咪变成卡通风格",
    "image": "https://example.com/cat.jpg",
    "ratio": "1:1",
    "resolution": "2k",
    "strength": 0.7
  }'

POST /v1/videos/seedance

Seedance舞蹈视频生成(图片驱动人物跳舞)

请求参数:
{
  "model": "jiguang-video-seedance-2.0",
  "image": "https://example.com/person.jpg",
  "dance_video": "https://example.com/dance.mp4",
  "resolution": "720p"
}
参数说明:
参数 类型 必填 说明
modelstring使用seedance模型
imagestring人物图片URL或base64
dance_videostring舞蹈动作视频URL
resolutionstring输出分辨率,默认720p
curl示例:
curl -X POST https://bytesite.xiaojiaixhs.com/v1/videos/seedance \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "jiguang-video-seedance-2.0",
    "image": "https://example.com/person.jpg",
    "dance_video": "https://example.com/dance.mp4",
    "resolution": "720p"
  }'
注意: Seedance功能需要提供清晰的人物正面照和舞蹈动作视频,生成时间较长(约1-3分钟)

GET /v1/models

获取可用模型列表

curl示例:
curl -X GET https://bytesite.xiaojiaixhs.com/v1/models \
  -H "Authorization: Bearer YOUR_API_KEY"
响应示例:
{
  "data": [
    {"id": "jiguang-5.0", "type": "image"},
    {"id": "jiguang-video-3.5-pro", "type": "video"}
  ]
}

在线测试工具