Seedream MCP

하나의 연결로 만나는 창작 모델.

AI 어시스턴트를 연결하고 모델을 선택해 기존 크레딧으로 이미지와 동영상을 만드세요.

API 키 만들기

창작의 시작점 선택

이미지 모델…

동영상 모델…

어시스턴트 연결

MCP 주소

https://seedream-5.io/api/mcp

AI 도구를 실행하는 환경에 SEEDREAM_API_KEY를 설정하고 아래 설정을 복사하세요. 로컬 테스트 시 주소를 변경하세요.

~/.codex/config.toml

[mcp_servers.seedream]
url = "https://seedream-5.io/api/mcp"
bearer_token_env_var = "SEEDREAM_API_KEY"

Streamable HTTP · Bearer

검증 범위 및 클라이언트 문서

Codex: 이미지 생성·URL 편집·결과 조회 검증 완료. Cursor / Grok Build: 연결 및 도구 탐색 검증 완료. Claude Code: 연결 검증 완료. 뒤 세 클라이언트의 전체 작업 흐름은 검증 전입니다.

추가 모델의 프로덕션 이미지 생성, URL 편집 및 Codex 네이티브 MCP 도구 호출을 검증했습니다. 각 클라이언트에서 AI가 수행하는 전체 흐름은 추가 검증이 필요합니다.

Codex Cursor Claude Code Grok

이미지 플레이그라운드

모델과 설정을 선택한 뒤 연결된 AI에 인수를 복사하세요. 연결 설정은 공통입니다.

예시 모델출력 비율해상도출력 형식

prompt필수

빈 값이 아닌 텍스트, 최대 3000자. 이미지나 변경 사항을 설명합니다.

예상 비용… 크레딧

입력 매개변수

매개변수	필수 / 선택	유형, 값 및 제한
`model`	선택	`string`seedream-5-pro 모델 ID입니다. 생략하면 Seedream 5 Pro를 사용합니다. 기본값: seedream-5-pro
`request_id`	필수	`string` 영문, 숫자, _, -로 된 8~128자. 새 이미지마다 새 ID를 사용하고 같은 작업을 재시도할 때는 유지하세요.
`prompt`	필수	`string` 빈 값이 아닌 텍스트, 최대 3000자. 이미지나 변경 사항을 설명합니다.
`aspect_ratio`	선택	`string`1:1 · 2:3 · 3:2 · 3:4 · 4:3 · 9:16 · 16:9 · 21:9 출력 이미지 비율입니다. 참조 비율을 유지하려면 같은 비율을 선택하세요. auto는 Nano Banana 2만 지원합니다. 기본값: 1:1
`resolution`	선택	`string`1K · 2K 해상도 단계입니다. 실제 픽셀 크기는 비율에 따라 달라집니다. 기본값: 1K
`output_format`	선택	`string`jpeg · png 소문자 jpeg 또는 png. 기본값: jpeg
`image_urls`	이미지 편집에서만 필수	`string[]` 공개 HTTPS 도메인 이미지 URL 1~10개의 배열, URL당 최대 4096자. 기본 포트 또는 443만 사용하세요. IP 주소, 로컬 경로, base64, 로그인 필요 URL은 불가합니다. 텍스트 생성에서는 생략하세요.

표에 있는 매개변수만 지원합니다. 잘못된 값은 제출 및 크레딧 예약 전에 거절됩니다. 요청당 한 장입니다.

조회 도구

seedream_get_model_info: model은 선택입니다. {}는 전체 모델 및 기본 Pro 옵션을 반환합니다.
seedream_get_balance: 인수 없음: {}. 계정 크레딧과 키 잔여 한도를 반환합니다.
seedream_get_task: task_id 필수: 생성 시 반환된 UUID를 입력하세요.

동영상 플레이그라운드

같은 주소와 키를 사용합니다. Standard/Pro와 모드를 선택하고 인수를 연결된 AI에 복사하세요. 예제는 작업을 제출하지 않습니다.

예시 모델해상도출력 비율길이(초)

오디오 생성시드(선택)

prompt필수

예상 비용… 크레딧

복사할 호출 인수

예제 만들기 · 여기서는 크레딧을 사용하지 않습니다

길이(초): 2–30

seedream_generate_video

{
  "model": "wan-3.0-standard",
  "request_id": "generate_video_001",
  "mode": "text-to-video",
  "prompt": "부드러운 아침 햇살 속 나무 탁자의 도자기 주전자에 카메라가 천천히 다가갑니다.",
  "aspect_ratio": "adaptive",
  "resolution": "720P",
  "duration": 5,
  "audio": true
}

새 동영상마다 새 request_id. 재시도는 동일 ID와 인수를 사용하며 변경 시 충돌합니다.

seedream_generate_video를 한 번 호출한 뒤 반환된 task_id로 seedream_get_task를 5초마다 조회합니다. 완료 시 동영상 URL과 resource_link를 받습니다. 연결이 끊겨도 계속 처리됩니다. SUBMISSION_UNCERTAIN은 재제출하지 말고 지원팀에 문의하세요.

참조 미디어와 제한

텍스트 모드는 prompt 필수. 프레임 모드는 first_frame_url/last_frame_url 중 하나 이상, 참조 모드는 참조 URL 배열 하나 이상이 필요합니다. 프레임과 참조는 혼합할 수 없습니다. 미디어 모드의 prompt는 선택입니다.

공개 HTTPS URL만 지원하며 로컬 파일, base64, 로그인 URL은 안 됩니다. 이미지 최대10개 JPEG/PNG/BMP/WebP, 각20 MiB 이하, 변240–8000 px, 비율8 이하. 동영상 최대5개 MP4/MOV, 각100 MiB 이하, 변240–4096 px, 비율8 이하. 오디오 최대5개 WAV/MP3, 각15 MiB 이하. 동영상/오디오 각1–15초, 유형별 합계15초 이하. 참조 동영상+출력30초 이하. 완료까지 URL을 유지해야 하며 실제 파일은 생성 서비스가 검증합니다.

기본: Standard, 텍스트, 720P(Pro1080P), adaptive, 5초, 오디오 켜짐. MP4 고정, 픽셀은 비율에 따라 달라집니다.

입력 매개변수

매개변수	필수 / 선택	유형, 값 및 제한
`request_id`	필수	`string · 8–128 · A–Z a–z 0–9 _ -`
`model`	선택	`wan-3.0-standard \| wan-3.0-prime \| wan-3.0-pro \| wan-3.0-prime-pro` 기본값: wan-3.0-standard
`mode`	선택	`text-to-video \| keyframe-to-video \| reference-to-video` 기본값: text-to-video
`prompt`	필수	`string · 1–20000`
`aspect_ratio`	선택	`16:9 \| 9:16 \| 1:1 \| 4:3 \| 3:4 \| adaptive` 기본값: adaptive
`resolution`	선택	기본값: …
`duration`	선택	`integer · 2–30 s` 기본값: 5
`audio`	선택	`boolean · true \| false` 기본값: true
`seed`	선택	`integer · 0–2147483647`
`first_frame_url / last_frame_url`	필수 · 첫 / 마지막 프레임	`string · HTTPS · ≤4096`
`reference_image_urls`	선택 · 참조 미디어	`string[] · 1–10 · HTTPS · ≤4096 / URL`
`reference_video_urls`	참조 미디어	`string[] · 1–5 · HTTPS · ≤4096 / URL`
`reference_audio_urls`	참조 미디어	`string[] · 1–5 · HTTPS · ≤4096 / URL`
`reference_video_durations / reference_audio_durations`	선택	`number[] · 1–15 s / item · total ≤15 s`

요청당 MP4 1개. output_format 및 공급자/안전 설정은 지원하지 않습니다. 잘못된 인수는 예약 전에 거부됩니다. 접근 불가·초과 미디어도 실패할 수 있습니다. 선택 시간 배열은 URL 수와 순서에 맞춰야 하며 실제 검증을 우회하지 못합니다.

내 API 키

AI 도구마다 별도의 키와 사용 한도를 설정하세요. 호출 예시 및 매개변수

로딩 중…