Pixapi

外观

Seedance ​

Seedance 2 支持同步音频、首尾帧控制与多模态参考。

API 接口 ​

操作端点模式
视频生成任务POST /v1/async/videos/generations仅异步

模型 ​

模型 id说明
seedance-2完整画质，最高 4k。seconds 为 4–15。
seedance-2-fast更快，最高 720p。seconds 为 4–15。
seedance-2-mini最低成本，最高 720p。seconds 仅 4 / 8 / 10 / 12 / 15。仅允许 n=1。

价格 ​

按 n × seconds × 单价(resolution) 计费。默认 720p。

模型480p720p1080p4K
seedance-2-mini4/秒8/秒——
seedance-2-fast6/秒13/秒——
seedance-28/秒16/秒38/秒78/秒

示例：seedance-2 + 720p + seconds=5 + n=1 → 16 × 5 = 80 积分。

请求字段 ​

通用字段放在请求体一级，下面列出的模型专用参数放进 providerOptions。

字段类型必填说明
modelstring是seedance-2, seedance-2-fast, seedance-2-mini
promptstring是描述主体、动作、镜头运动与风格；Pixapi 支持 1–2,000 字符。
secondsinteger是标准版／Fast：整数 4–15；Mini：4、8、10、12、15；Pixapi 必须填写。
resolutionstring否480p / 720p; seedance-2: 1080p / 4k. Pixapi 默认：720p。
ninteger否默认 1，只支持整数 1。
imagestring / string[]否公网图片 URL，可提供最多 9 张参考图；指定首尾帧时改用 image_with_roles。
providerOptionsobject否模型专用选项，详见下表。

providerOptions ​

本表所有字段都写在 providerOptions 内，不要与 model 并列。

字段类型说明
aspect_ratiostring21:9, 16:9, 4:3, 1:1, 3:4, 9:16, adaptive. 默认 16:9；图生视频按输入图比例。
generate_audioboolean默认 true，生成同步声音；false 输出无声视频。
seedinteger控制随机性；相同种子可能产生相似视频，不保证完全一致。
image_with_rolesobject[]每项 {url,role}；first_frame ≤1、last_frame ≤1、reference_image ≤9。首尾帧不能和参考素材模式混用；与一级 image 二选一。
video_urlsstring[]最多 3 段公网参考视频，480p–720p；总时长大于 1.8、低于 15.2 秒，不能与首尾帧模式同用。
audio_urlsstring[]最多 3 段公网参考音频，总时长 ≤15 秒；必须配合参考图或视频，不用于首尾帧模式。
return_last_frameboolean默认 false；额外返回末帧图片。
toolsobject[]联网搜索辅助：[{"type":"web_search"}]。
nsfw_checkboolean是否审核提示词和图片，默认 false。

输入规则 ​

使用 Pixapi 的 seedance-2 等模型名；图生视频也必须提供非空提示词。

示例 ​

bash
curl https://api.pixapi.ai/v1/async/videos/generations \
  -H "Authorization: Bearer $PIXAPI_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "model": "seedance-2",
  "prompt": "一只柴犬穿过霓虹雨夜街道",
  "n": 1,
  "seconds": 5,
  "resolution": "720p",
  "providerOptions": {
    "generate_audio": true,
    "aspect_ratio": "16:9"
  }
}'
py
import os
import requests

response = requests.post(
    "https://api.pixapi.ai/v1/async/videos/generations",
    headers={
        "Authorization": f"Bearer {os.environ['PIXAPI_KEY']}",
        "Content-Type": "application/json",
    },
    json={
    "model": "seedance-2",
    "prompt": "一只柴犬穿过霓虹雨夜街道",
    "n": 1,
    "seconds": 5,
    "resolution": "720p",
    "providerOptions": {
        "generate_audio": True,
        "aspect_ratio": "16:9"
    }
},
)
response.raise_for_status()
task = response.json()
print(task["id"])
js
const response = await fetch('https://api.pixapi.ai/v1/async/videos/generations', {
  method: 'POST',
  headers: {
    Authorization: `Bearer ${process.env.PIXAPI_KEY}`,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
  "model": "seedance-2",
  "prompt": "一只柴犬穿过霓虹雨夜街道",
  "n": 1,
  "seconds": 5,
  "resolution": "720p",
  "providerOptions": {
    "generate_audio": true,
    "aspect_ratio": "16:9"
  }
}),
});

if (!response.ok) {
  throw new Error(await response.text());
}

const task = await response.json();
console.log(task.id);
go
package main

import (
  "bytes"
  "fmt"
  "io"
  "net/http"
  "os"
)

func main() {
  body := []byte(`{
  "model": "seedance-2",
  "prompt": "一只柴犬穿过霓虹雨夜街道",
  "n": 1,
  "seconds": 5,
  "resolution": "720p",
  "providerOptions": {
    "generate_audio": true,
    "aspect_ratio": "16:9"
  }
}`)

  req, err := http.NewRequest(
    "POST",
    "https://api.pixapi.ai/v1/async/videos/generations",
    bytes.NewBuffer(body),
  )
  if err != nil {
    panic(err)
  }
  req.Header.Set("Authorization", "Bearer "+os.Getenv("PIXAPI_KEY"))
  req.Header.Set("Content-Type", "application/json")

  resp, err := http.DefaultClient.Do(req)
  if err != nil {
    panic(err)
  }
  defer resp.Body.Close()

  result, _ := io.ReadAll(resp.Body)
  fmt.Println(string(result))
}

响应 ​

返回已提交任务。轮询 GET /v1/tasks/{id} 获取结果。