EvoLink API로 연동
추천: 제품 백엔드, 배치 작업, 자동화 워크플로
서버에서 EvoLink 통합 영상 API를 직접 호출하고 모델 ID, 파라미터, 작업 큐, callback, 결과 저장을 제어합니다.
- 1실제 브리프로 Playground에서 결과와 비용 검증
- 2콘솔에서 EvoLink API 키 생성
- 3위 라우트 카드에서 작업에 맞는 모델 ID 선택
- 4작업을 제출하고 폴링 또는 HTTPS callback으로 결과 수신
EvoLink 통합 비디오 API로 Grok Imagine Video 1.5(xAI의 Grok 영상 모델)를 사용하세요. 먼저 텍스트·이미지·레퍼런스 기반 영상 생성과 네이티브 오디오를 테스트해 보세요.
비동기 API를 연동하기 전에 프롬프트를 작성하고 필요하면 이미지를 최대 7장까지 첨부해 크레딧 사용량을 미리 계산하고 결과를 확인해 볼 수 있습니다.
샘플 만들기
프롬프트를 입력하고 필요하면 이미지를 첨부한 뒤 파라미터를 설정하세요.선택 사항, 최대 7장. 0장 = 텍스트 기반 · 1장 = 이미지 기반 · 2~7장 = 참조 이미지 기반
1generated-image.png
—
✓ 이미지 1개를 추가했습니다
입력 이미지가 1장일 때는 적용되지 않습니다. 출력은 해당 이미지 크기를 따릅니다.
생성 결과는 24시간 동안 보관됩니다. 필요한 파일은 미리 다운로드하세요.
모든 모드에 필요한 크레딧을 계획하세요. 출력은 길이와 해상도에 따라 과금되며, 입력 이미지마다 소액의 고정 요금이 추가됩니다. 프롬프트만 사용하는 텍스트 기반 생성에는 이미지 요금이 없습니다.
첫 테스트 비용
텍스트 기반 동영상 - 1초 - 480p입력 이미지 없는 1초 480p 샘플 1개
$10 크레딧으로 약 178회 테스트.
크레딧을 아끼려면 480p로 반복 테스트한 뒤, 모션과 구도가 확정되면 검토용으로 720p 또는 1080p로 전환하세요.
테스트 예산 가이드
예상 테스트 횟수에 맞춰 금액을 선택하세요.처음 검증해 보기에 좋습니다.
모션과 구도를 다듬기에 좋습니다.
프로덕션 연동 전 단계에 좋습니다.
입력 이미지 1장을 포함한 1회 생성 기준 예상 총비용입니다. 실제 비용은 길이, 해상도, 첨부한 이미지 장수에 따라 달라질 수 있습니다.
grok-imagine-video-1.5-preview| 항목 | 480p | 720p | 1080p | 과금 |
|---|---|---|---|---|
| 동영상 생성출력 동영상, 초당 | $0.056/s-30% 3.808 cr/s$0.080 공식 가격 | $0.098/s-30% 6.664 cr/s$0.140 공식 가격 | $0.175/s-30% 11.9 cr/s$0.250 공식 가격 | 출력 동영상 초 |
출력은 초당 과금됩니다(720p = 480p x 1.75, 1080p = 480p x 3.125). 입력 이미지는 0~7장 범위에서 장당 소액의 고정 요금이 부과됩니다.
| 부가 항목 | 적용 시점 | 가격 | 크레딧 |
|---|---|---|---|
| 입력 이미지 | 입력 이미지당(0~7장, 선택 사항) | $0.0070/장-30% $0.010 공식 가격 | 0.476 cr |
입력 이미지는 선택 사항입니다. 첨부한 이미지는 모든 플랜에서 장당 1회 고정 요금으로 과금되며, 프롬프트만 사용하는 텍스트 기반 요청에는 이미지 요금이 없습니다.
Grok Imagine Video 1.5는 xAI가 GA로 제공하는 동영상 생성 모델입니다. EvoLink에서는 하나의 모델 ID가 세 가지 생성 모드를 모두 담당하며, 입력 이미지 장수가 모드를 결정합니다. 이미지를 보내지 않으면 텍스트 기반, 한 장을 보내면 그 이미지를 첫 프레임으로 사용하는 이미지 기반, 두 장에서 일곱 장을 보내면 참조 이미지를 결합하는 참조 기반이 됩니다. 모든 요청에는 프롬프트가 필요하며 1~15초 길이의 480p, 720p 또는 1080p 동영상을 반환합니다. 이 라우트는 네이티브 오디오, 비동기 작업 처리, 실시간 비용 예측을 지원하는 숏폼 생성용으로 설계되었으며 다른 모델과 하나의 API Key를 공유합니다.
grok-imagine-video-1.5-preview모델 ID 하나로 세 가지 모드를 모두 처리합니다. 이미지 없이는 텍스트-비디오, 1장은 이미지 애니메이션, 2-7장은 참조 블렌딩입니다. xAI 업스트림 안정 ID는 grok-imagine-video-1.5이며 EvoLink는 현재 preview 별칭으로 라우팅합니다.
제품 연동과 배치 작업에는 EvoLink API를 사용하고, 빠른 제작·개발 작업에는 Codex, Claude 또는 Gemini에서 Agent로 호출할 수 있습니다. 두 방식은 동일한 EvoLink API 키, 잔액, 모델 라우트, 작업 기록을 공유합니다.
추천: 제품 백엔드, 배치 작업, 자동화 워크플로
서버에서 EvoLink 통합 영상 API를 직접 호출하고 모델 ID, 파라미터, 작업 큐, callback, 결과 저장을 제어합니다.
추천: Codex, Claude, Gemini의 제작 및 개발 작업
생성 목표, 자료, 검수 조건을 Agent에 전달하면 라우트 선택, 요청 구성, 작업 추적, 결과 반환까지 맡길 수 있습니다. 각 단계를 직접 코딩할 필요가 없습니다.
프롬프트만으로 생성하거나, 준비된 제품 사진이나 스토리보드 프레임에 움직임을 더하거나, 참조 이미지 2~7장을 결합할 수 있습니다. 모델 이름이나 엔드포인트를 바꿀 필요가 없습니다.
모델은 한 번의 생성 과정에서 움직임과 함께 동기화된 주변음, 음향 효과, 음성을 생성할 수 있습니다. 자체 승인 기준에 따라 오디오 품질을 검증하세요.
작업을 한 번 제출하고 폴링 또는 콜백으로 상태를 추적한 뒤 임시 결과 URL이 만료되기 전에 완성된 에셋을 영구 저장하세요.
제품 사진과 캠페인 핵심 비주얼을 짧은 모션 콘셉트와 크리에이티브 변형으로 전환하세요.
Playground에서 사용해 보기소셜 워크플로용 세로형, 정사각형 또는 가로형 클립을 카메라 지시와 선택적 오디오 지시와 함께 생성하세요.
Playground에서 사용해 보기더 큰 규모의 프로덕션을 진행하기 전에 스토리보드 프레임을 바탕으로 카메라 움직임, 인물 연기, 물리 효과, 타이밍과 장면의 리듬을 테스트하세요.
Playground에서 사용해 보기가장 짧은 실행 흐름을 보여 줍니다. 작업을 생성하고 반환된 task ID를 저장한 다음 폴링하거나 HTTPS callback을 기다립니다. 전체 파라미터와 응답 구조는 API 탭에서 확인하세요.
curl -X POST https://api.evolink.ai/v1/videos/generations \
-H "Authorization: Bearer $EVOLINK_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "grok-imagine-video-1.5-preview",
"prompt": "The person starts dancing under stage lights",
"duration": 6,
"quality": "480p",
"aspect_ratio": "16:9",
"callback_url": "https://your-domain.com/webhooks/video-task-completed"
}'
# Save the returned task ID, then query:
curl https://api.evolink.ai/v1/tasks/{task_id} \
-H "Authorization: Bearer $EVOLINK_API_KEY"위 파라미터 카드와 대조해 값 범위, 허용 옵션, 자료 개수, 파일 형식이 선택한 라우트 요건에 맞는지 확인하세요.
Authorization Bearer Token을 확인하고 콘솔에서 사용 가능 잔액과 작업 과금을 확인하세요.
초상권, 브랜드 자료, 읽을 수 있는 텍스트, 민감한 콘텐츠, 입력 자료의 적합성을 확인하세요.
최종 상태가 실패인 Grok Imagine Video 1.5 작업은 과금되지 않습니다. task ID를 보관하고 검증, 심사, 실행 중 어느 단계가 원인인지 확인한 후 재시도하세요.
callback_url은 공개 HTTPS URL이어야 하며 localhost 또는 사설 네트워크를 사용할 수 없습니다. 폴링 대안으로 task ID도 보관하세요.
| 기능 | Grok Imagine Video 1.5 | 프로덕션 영향 | 다른 라우트를 선택해야 하는 경우 |
|---|---|---|---|
| 생성 모드 | 텍스트·이미지·참조 기반 동영상 생성 | 이미지 장수가 모드를 결정하므로 한 번의 연동으로 세 가지를 모두 지원합니다. | 시작·종료 프레임이나 동영상 기반 편집이 필요한 경우. |
| 입력 사양 | 이미지 0~7장 + 비어 있지 않은 프롬프트 | 제출 전에 프롬프트를 검증하고 이미지 목록을 7장 이내로 제한하세요. | 참조 이미지가 7장을 넘거나 동영상 입력이 필요한 경우. |
| 길이 및 출력 | 480p, 720p 또는 1080p에서 1~15초 | 비용은 길이와 해상도에 따라 달라집니다. | EvoLink에서 15초를 넘는 클립이 필요한 경우. |
| 출력 구도 | 기본값은 auto, 고정 5가지도 선택 가능. 소스 이미지 1장이면 그쪽이 우선 | 프롬프트 전용·다중 참조 생성에서는 비율을 지정하세요. auto는 구도를 업스트림 채널에 맡깁니다. | 4:3, 3:4 또는 지원 목록 밖의 비율이 필요한 경우. |
| 결과 제공 | 폴링 또는 콜백을 지원하는 비동기 작업 | 작업을 대기열에 넣고 최종 상태를 멱등적으로 처리하세요. | 워크플로에 즉시 반환되는 동기식 결과가 필요한 경우. |
| 과금 | 출력 초당 + 입력 이미지당 | 각 작업의 비용을 예측하고 재시도 지출에 상한을 설정하세요. | 길이와 무관한 고정 비용이 필요한 경우. |
xAI는 grok-imagine-video-1.5를 안정 모델로 명시합니다. EvoLink는 현재 grok-imagine-video-1.5-preview를 허용하므로 EvoLink 예시에 표시된 ID를 사용하세요.
모드 파라미터는 없습니다. 텍스트 기반 생성에는 image_urls를 생략하고, 최대 10 MB의 JPEG·PNG·WebP 이미지를 한 장 보내면 첫 프레임으로 사용하며, 두 장에서 일곱 장을 보내면 참조 이미지로 결합합니다. 여덟 장 이상은 거부됩니다.
작업을 제출하고 폴링하거나 콜백을 수신한 뒤 완성된 동영상을 영구 저장하세요. EvoLink 결과 URL은 24시간 동안 제공됩니다.
실시간 라우트 가격을 사용해 생성 전에 길이, 해상도, 입력 이미지 비용을 예측하세요.
하나의 인증 및 통합 계층을 통해 Grok Imagine과 다른 동영상 모델을 호출하세요.
동일한 EvoLink 계정에서 크레딧, 지출, 모델 사용량을 관리하세요.
일관된 비동기 워크플로를 통해 대기 중, 처리 중, 완료, 실패 상태의 작업을 추적하세요.
Grok 1.5는 프롬프트, 단일 프레임, 다중 참조 기반 생성에 사용하고 다른 모달리티는 더 적합한 모델로 라우팅하세요.
하나의 EvoLink 계정과 API 키로 Grok Imagine 라우트를 비교하고 출력 품질, 길이, 비용에 따라 선택하세요.

Grok Imagine Video 1.5
Grok Imagine Video 1.5는 xAI가 GA로 제공하는 동영상 생성 모델입니다. EvoLink에서는 하나의 모델 ID가 세 가지 생성 모드를 모두 담당하며, 입력 이미지 장수가 모드를 결정합니다. 이미지를 보내지 않으면 텍스트 기반, 한 장을 보내면 그 이미지를 첫 프레임으로 사용하는 이미지 기반, 두 장에서 일곱 장을 보내면 참조 이미지를 결합하는 참조 기반이 됩니다. 모든 요청에는 프롬프트가 필요하며 1~15초 길이의 480p, 720p 또는 1080p 동영상을 반환합니다. 이 라우트는 네이티브 오디오, 비동기 작업 처리, 실시간 비용 예측을 지원하는 숏폼 생성용으로 설계되었으며 다른 모델과 하나의 API Key를 공유합니다.
API 보기
Grok Imagine Video (1.0)
텍스트 기반 동영상, 이미지 기반 동영상, 참조, 편집, 확장 워크플로를 지원하는 더 포괄적인 Grok Imagine 동영상 라우트입니다.
API 보기



Grok Imagine Video 1.5는 xAI가 GA로 제공하는 동영상 생성 모델입니다. 프롬프트, 소스 이미지 한 장, 또는 두 장에서 일곱 장의 참조 이미지를 네이티브 오디오 기능이 포함된 짧은 동영상으로 변환합니다.
EvoLink 요청에서는 grok-imagine-video-1.5-preview를 사용하세요. xAI 업스트림의 안정 버전 ID는 grok-imagine-video-1.5이지만 모델 ID는 채널별로 다릅니다.
preview라는 이름은 업스트림 별칭으로 유지되고 있으며 EvoLink 라우트의 현재 공개 ID입니다. 이는 xAI가 1.5 릴리스를 계속 Preview로 분류한다는 의미가 아닙니다.
네. image_urls를 생략하거나 빈 배열을 보내면 프롬프트만 사용하는 텍스트 기반 생성으로 실행됩니다. 이 경우 이미지 요금은 부과되지 않습니다.
네. image_urls에 두 장에서 일곱 장의 이미지를 보내면 이를 결합하는 참조 기반 생성으로 실행됩니다. 여덟 장 이상은 거부됩니다. 시작·종료 프레임 워크플로는 여전히 지원되지 않습니다.
모드 파라미터는 전달하지 않습니다. image_urls에 담긴 유효한 이미지 장수가 결정합니다. 0장이면 텍스트 기반, 1장이면 그 이미지를 첫 프레임으로 쓰는 이미지 기반, 2~7장이면 이미지들을 결합하는 참조 기반으로 생성됩니다.
프롬프트는 항상 필수이며 최대 2,000 토큰까지 사용할 수 있습니다(한국어 등은 문자당 토큰 소모가 더 큽니다). 이미지는 선택 사항으로, 최대 10 MB의 JPEG·PNG·WebP 파일을 7장까지 보낼 수 있습니다.
EvoLink는 출력 길이와 해상도에 따라 과금하고 첨부한 입력 이미지마다 장당 요금을 추가합니다. 복사된 정적 가격 대신 실시간 가격 섹션과 Playground 예측을 통해 현재 라우트 가격을 확인하세요.
EvoLink 라우트는 480p, 720p, 1080p 출력과 1~15초 길이를 지원합니다. 출력은 480p 요금을 기준으로 초당 과금되며 720p는 1.75배, 1080p는 3.125배입니다. 이는 xAI 공식 초당 가격 비율과 동일합니다.
텍스트-투-비디오와 참조 이미지 기반 생성(2~7장)은 aspect_ratio 파라미터를 지원합니다: auto(기본값), 16:9, 9:16, 1:1, 3:2, 2:3. auto는 업스트림 채널이 구도를 결정하므로 생성할 때마다 달라질 수 있습니다. 일정한 구도가 필요하면 고정 비율을 지정하세요. 입력 이미지가 1장일 때는 이 파라미터가 무시되고 출력이 해당 이미지 크기를 따릅니다.
이 모델은 동영상과 함께 동기화된 주변음, 음향 효과, 음성을 생성하도록 설계되었습니다. 오디오 품질은 장면마다 달라질 수 있으므로 자체 승인 기준에 따라 테스트하세요.
생성은 비동기 방식입니다. 작업을 제출하고 상태를 폴링하거나 HTTPS 콜백을 제공한 뒤 작업이 완료되면 반환된 동영상을 영구 저장하세요.
EvoLink 결과 URL은 24시간 동안 제공됩니다. 프로덕션에서 임시 URL을 사용하지 말고 완성된 에셋을 자체 오브젝트 스토리지에 복사하세요.
실패하거나 검토 대상이 된 모든 요청이 무료라고 가정하지 마세요. 재시도하기 전에 작업에서 반환된 사용량 및 과금 필드를 확인하고 현재 계정 기록을 검토하세요.