공급자 라우팅

하나의 비디오 모델이 둘 이상의 공급자에서 제공될 수 있습니다. provider는 요청 본문 최상위 필드이며 두 개의 하위 필드를 받습니다: type은 어느 공급자로 갈지 지정하고, options는 해당 공급자 고유 파라미터를 전달합니다.

필드	타입	설명
`provider.type`	string	제공 공급자를 지정합니다. 열거에 없는 값은 `400 invalid_provider_type`, 해당 모델을 제공하지 않는 공급자는 `400 provider_type_unavailable`을 반환합니다
`provider.options.<slug>`	object	공급자별 passthrough — 매칭된 공급자만 받습니다

cURL

Terminal


curl https://api.ofox.io/v1/videos \
  -H "Authorization: Bearer $OFOX_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "bytedance/seedance-2.0-mini",
    "prompt": "...",
    "duration": 5,
    "provider": {
      "type": "byteplus",
      "options": { "dashscope": { "watermark": false } }
    }
  }'

Python

create_video.py


requests.post(
    "https://api.ofox.io/v1/videos",
    headers={"Authorization": f"Bearer {OFOX_API_KEY}"},
    json={
        "model": "bytedance/seedance-2.0-mini",
        "prompt": "...",
        "duration": 5,
        "provider": {
            "type": "byteplus",
            "options": {"dashscope": {"watermark": False}},
        },
    },
)

TypeScript

create-video.ts


await fetch('https://api.ofox.io/v1/videos', {
  method: 'POST',
  headers: {
    Authorization: `Bearer ${OFOX_API_KEY}`,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    model: 'bytedance/seedance-2.0-mini',
    prompt: '...',
    duration: 5,
    provider: {
      type: 'byteplus',
      options: { dashscope: { watermark: false } },
    },
  }),
})

provider.type을 보내지 않으면 여러 공급자가 제공하는 모델은 가용 채널에 가중치를 두어 분배되며, 개별 요청을 어느 공급자가 처리할지는 예측할 수 없습니다. 비디오 경로는 order / sort / fallback을 지원하지 않으며 동등한 헤더 방식도 없습니다.

지정 가능한 공급자는 해당 모델 페이지의 공급자 영역에 나열된 것들이며, 전체 목록은 공급자 라우팅을 참고하세요.

seedance의 두 공급자

bytedance/seedance-* 계열은 아래 두 공급자가 제공하며, 두 공급자의 콘텐츠 정책이 다릅니다:

공급자	설명	콘텐츠 정책
`volcengine`	Volcengine Ark, 바이트댄스의 중국 본토 플랫폼	표준 심사
`byteplus`	BytePlus, 바이트댄스의 해외 플랫폼	모든 이용자에게 적합하지 않은(NSFW) 콘텐츠 지원

byteplus는 seedance가 모든 이용자에게 적합하지 않은(NSFW) 콘텐츠를 생성하도록 허용하고, volcengine은 표준 심사를 적용합니다. 그러한 콘텐츠가 필요하면 provider.type: "byteplus"를 명시적으로 지정해야 합니다. 지정하지 않으면 가중 분배로 요청이 volcengine에 전달되어 심사에서 거부될 수 있습니다.

`provider.options`: 파라미터 passthrough

공급자별 파라미터는 provider.options.<slug>로 전달되며 매칭된 공급자만 받습니다. watermark 같은 파라미터는 모든 모델이 지원하지는 않기 때문에 최상위 필드가 아니라 공급자 passthrough에 두었습니다(OpenRouter의 passthrough 설계와 동일). 어떤 passthrough 파라미터를 받는지는 모델에 따라 다릅니다.


{
  "model": "alibaba/wan-2.7",
  "prompt": "...",
  "provider": {
    "options": {
      "dashscope": { "watermark": false, "audio_setting": "..." }
    }
  }
}

type과 options는 함께 보낼 수 있습니다.