ToAPIs
    홈ToAPIs
    이미지 생성GPT Image 2.6, Gemini, FLUX…비디오 생성Seedance, Veo, Kling, Sora…채팅 및 글쓰기GPT-5.6, Claude, DeepSeek…음성 및 음악더빙, TTS, 오디오
    신규 출시Seedance 2.5
    요금제API 문서MCP
    블로그대안
    로그인무료 시작
    전체 모델요금제API 문서MCP블로그대안
    로그인무료 시작

    언어

    Esc
    • Seedance 2.5비디오 생성
    • GPT Image 2이미지 생성
    • GPT Image 2.6이미지 생성
    • GPT Image 2.5이미지 생성
    • Veo 3.1 Fast비디오 생성
    • Kling 3.0 Turbo비디오 생성
    • Kling V4 Flash비디오 생성
    • Grok Video 1.5비디오 생성
    • Nano Banana 2이미지 생성
    • Seedream 5.5이미지 생성
    • FLUX이미지 생성
    • Sora 2비디오 생성
    • 전체 이미지 모델카테고리
    • 전체 비디오 모델카테고리
    • GPT-5.6 Sol채팅 및 코딩
    • Claude Opus 4.8채팅 및 코딩
    • Claude Opus 4.7채팅 및 코딩
    • DeepSeek V4 ProDeepSeek · 텍스트
    • Gemini Omni 1.1 FlashGoogle · 멀티모달
    1. 홈
    2. 블로그
    3. 튜토리얼
    4. OpenAI 호환 엔드포인트로 Grok Video 3 API에 접근하기
    전체 글 목록으로
    tutorial2026-11-176 분 읽기

    OpenAI 호환 엔드포인트로 Grok Video 3 API에 접근하기

    OpenAI 호환 클라이언트를 ToAPIs로 향하게 해 현재 Grok Video 카탈로그 ID를 호출합니다. Bearer 인증과 /v1 오리진은 공유하고, 비디오 작업은 미공개 grok-video-3 경로가 아니라 POST /v1/videos/generations를 사용합니다.

    ToAPIs Engineering & Evaluation Team
    Grok VideoOpenAI CompatibleVideo APIAPI GatewayTutorial
    TL;DR - 핵심 요약
    • ToAPIs는 통합 OpenAI 호환 /v1 오리진과 Bearer API 키를 문서화합니다. openai-video 엔드포인트에 현재 나열된 Grok Video ID는 grok-video-1.0과 grok-video-1.5이며 grok-video-3가 아닙니다.
    • 비디오 모델은 GET /v1/models?type=video로 나열하세요. 기본 모델 목록은 텍스트 모델만 반환합니다. type을 생략하면 Grok Video ID가 보이지 않습니다.
    • 생성은 POST /v1/videos/generations, 폴링은 GET /v1/videos/generations/{id}입니다. 이것이 문서화된 비디오 계약입니다. 계정 문서가 말하지 않는 한 ToAPIs에 client.videos.create 같은 OpenAI Videos SDK 메서드가 있다고 가정하지 마세요.
    • 채팅, 업로드, 비디오에 같은 Authorization 헤더를 사용하세요. 로컬 자산은 POST /v1/uploads/images로 업로드한 뒤 반환된 공개 URL을 전달하세요.
    • 정확한 모델 문자열과 실시간 요율은 계정에서 확인하세요. 호환 오리진만으로는 미공개 모델 ID나 고정 단가가 생기지 않습니다.

    OpenAI 호환 엔드포인트로 Grok Video 3 API에 접근하기

    대상 모델: grok-video-1.5, grok-video-1.0
    추론 엔드포인트: https://api.toapis.com/v1/videos/generations
    관련 글: Grok Video 실습 가이드 · Grok Imagine 공식 채널 API · Chatbox OpenAI 호환 설정 · 모델 목록


    1. 핵심 요약 및 개요 (TL;DR)

    • 여기서 말하는 “OpenAI 호환”: ToAPIs는 단일 /v1 오리진, Bearer 인증, OpenAI 스타일 모델 목록과 채팅 완성 API를 문서화합니다. 공개 Grok Video ID는 카탈로그의 openai-video 엔드포인트 계열에 등록되어 있습니다. 이것이 미공개 grok-video-3가 동작한다는 뜻도, OpenAI Videos SDK 메서드가 문서화되었다는 뜻도 아닙니다.
    • ID: GET /v1/models?type=video에서 키에 보인 뒤에 grok-video-1.5 또는 grok-video-1.0을 사용하세요. 2026-11-10자 공개 카탈로그 스냅샷에는 grok-video-3가 없습니다.
    • 비디오 경로: 생성은 POST /v1/videos/generations, 폴링은 GET /v1/videos/generations/{id}입니다. 공식 예시는 https://toapis.com(중국 본토는 https://toapis.cn)입니다. 이 시리즈는 https://api.toapis.com도 사용합니다.
    • 공유 인증: Authorization: Bearer에 API 키 하나를 사용합니다. 이 비디오 호출을 위한 별도의 공개 OAuth 범위 문서는 없습니다.
    • 클라이언트 선택: 채팅과 익숙한 키/오리진 설정에는 OpenAI SDK의 base_url="https://api.toapis.com/v1"를 쓸 수 있습니다. Grok Video에서는 video_generation_mode와 이미지 URL 필드를 명시하기 위해 문서화된 REST JSON 본문을 사용합니다.

    2. 호환 오리진, 모델 목록, 비디오 경로

    오리진, /v1 접두사, 키는 함께 사용하세요. ToAPIs 키를 https://api.openai.com/v1과 섞거나, ToAPIs 오리진을 공급자 고유 Grok 경로와 조합하는 것은 다른 — 그리고 문서화되지 않은 — 구성입니다.

    단계문서화된 경로참고
    모델 목록GET /v1/models?type=video기본 GET /v1/models는 텍스트 모델만 반환합니다. type=video 또는 type=all을 사용하세요
    로컬 이미지 업로드POST /v1/uploads/images(multipart file)data.url을 읽으세요. 생성 호출에 base64를 보내지 마세요
    Grok Video 작업 생성POST /v1/videos/generations본문에 model, prompt, 1.5 모드/미디어 필드가 들어갑니다
    상태 폴링GET /v1/videos/generations/{id}종료 상태는 completed와 failed입니다
    채팅(비디오 아님)POST /v1/chat/completions오리진과 키만 공유합니다

    grok-video-1.5에서는 보내는 미디어에 맞게 video_generation_mode를 text_to_video, first_frame_image_to_video, 또는 reference_images_to_video로 설정하세요. 필드 계약은 Grok Video 실습 가이드와 Grok Video 1.5 API 레퍼런스를 보세요.

    호환 클라이언트 패널이 육각형 게이트웨이를 통해 제출 및 폴링 경로로 연결되는 그림

    그림 1: 클라이언트를 ToAPIs /v1 오리진으로 향하게 하고, 모델 목록에서 grok-video-1.5 또는 grok-video-1.0을 확인한 다음 /v1/videos/generations에서 제출하고 폴링하세요. chat/completions는 사용하지 않습니다.

    애플리케이션 코드가 아니라 데스크톱 클라이언트를 설정한다면 Chatbox 설정 가이드가 채팅용 호스트 필드 패턴을 다룹니다. 같은 채팅 경로가 비디오 파일을 반환할 것으로 기대하지 마세요.


    3. 프로덕션 구현: cURL과 Python

    이 시리즈의 국제 예시는 https://api.toapis.com을 사용합니다. 공식 문서는 중국 본토 사용자에게 https://toapis.cn을 안내합니다. 환경마다 오리진은 하나만 유지하세요.

    단계 1: ID를 확인한 뒤 cURL로 제출하기

    bash
    curl -sS "https://api.toapis.com/v1/models?type=video" \
      -H "Authorization: Bearer $TOAPIS_API_KEY"
    
    curl -X POST "https://api.toapis.com/v1/videos/generations" \
      -H "Authorization: Bearer $TOAPIS_API_KEY" \
      -H "Content-Type: application/json" \
      -d '{
        "model": "grok-video-1.5",
        "prompt": "A cinematic product shot with a slow camera push-in",
        "video_generation_mode": "text_to_video",
        "duration": 8,
        "resolution": "720p",
        "aspect_ratio": "16:9"
      }'
    

    하드코딩하기 전에 모델 목록의 정확한 id 문자열을 확인하세요. grok-video-3가 없으면 보내지 마세요.

    단계 2: Python — 오리진은 공유하고, 비디오는 REST로 호출

    여기 OpenAI SDK는 공유 base_url과 API 키만을 위해 보여 줍니다. 비디오 생성과 폴링은 비공식 클라이언트 매핑에서 1.5 본문 필드가 빠지지 않도록 문서화된 generations 경로를 유지합니다.

    python
    import os
    import time
    import requests
    from openai import OpenAI
    
    API_KEY = os.environ["TOAPIS_API_KEY"]
    BASE = "https://api.toapis.com"
    HEADERS = {
        "Authorization": f"Bearer {API_KEY}",
        "Content-Type": "application/json",
    }
    
    # Shared origin and key. Use this client for chat completions; do not assume
    # a videos.create mapping unless your account docs define one.
    client = OpenAI(base_url=f"{BASE}/v1", api_key=API_KEY)
    
    
    def list_video_model_ids() -> list[str]:
        res = requests.get(
            f"{BASE}/v1/models",
            headers=HEADERS,
            params={"type": "video"},
            timeout=30,
        )
        res.raise_for_status()
        data = res.json()
        items = data.get("data") or data.get("models") or []
        return [item.get("id") or item.get("name") for item in items if item]
    
    
    def dispatch_grok_video(prompt: str, model: str = "grok-video-1.5") -> str:
        available = set(list_video_model_ids())
        if available and model not in available:
            raise ValueError(f"{model} is not in this key's video model list")
        res = requests.post(
            f"{BASE}/v1/videos/generations",
            headers=HEADERS,
            json={
                "model": model,
                "prompt": prompt,
                "video_generation_mode": "text_to_video",
                "duration": 8,
                "resolution": "720p",
                "aspect_ratio": "16:9",
            },
            timeout=30,
        )
        res.raise_for_status()
        data = res.json()
        task_id = data.get("id") or data.get("task_id")
        if not task_id:
            raise RuntimeError(f"Unexpected submission envelope: {data}")
        return task_id
    
    
    def poll_task(task_id: str, deadline_s: int = 600) -> str:
        poll_url = f"{BASE}/v1/videos/generations/{task_id}"
        interval = 10.0
        start = time.time()
        time.sleep(5)
        while time.time() - start < deadline_s:
            poll = requests.get(poll_url, headers=HEADERS, timeout=15)
            if poll.status_code == 429:
                retry_after = poll.headers.get("Retry-After")
                time.sleep(float(retry_after) if retry_after else min(interval * 2, 120))
                continue
            poll.raise_for_status()
            data = poll.json()
            status = data.get("status")
            if status == "completed":
                return data["result"]["data"][0]["url"]
            if status == "failed":
                raise RuntimeError(f"Generation failed: {data.get('error')}")
            time.sleep(interval)
            interval = min(interval * 1.5, 30.0)
        raise TimeoutError(f"Task {task_id} exceeded {deadline_s}s; check status before retrying")
    
    
    if __name__ == "__main__":
        print("Video models (excerpt):", list_video_model_ids()[:20])
        task_id = dispatch_grok_video("A cinematic product shot with a slow camera push-in")
        print("Task:", task_id)
        print("Video:", poll_task(task_id))
    

    목록 응답 구조가 예상과 다르면 원본 JSON을 기록하고 계정의 모델 목록 페이지에 맞춰 파서를 조정하세요. ID가 없을 때 grok-video-3를 보내는 폴백을 만들지 마세요.


    4. 오류 처리 및 상태 매트릭스

    아래 표는 진단 출발점이며 ToAPIs 오류 코드와 완전히 일치한다고 보장하지 않습니다. HTTP 조회가 성공해도 작업 status를 읽어야 합니다. 오류 레퍼런스를 보세요.

    HTTP 또는 작업 상태흔한 분류권장 조치
    400알 수 없는 모델 ID, 모드/미디어 불일치, 또는 비디오 본문을 채팅 경로로 보냄GET /v1/models?type=video로 ID를 확인하고, /v1/videos/generations에 POST했는지, 1.5 작업에 일치하는 video_generation_mode가 있는지 확인
    401API 키 누락 또는 무효OpenAI 플랫폼 키가 아니라 ToAPIs 키를 쓰고 Bearer 헤더를 확인
    404잘못된 오리진, /v1 누락, 또는 /videos/tasks/{id} 같은 임의 경로제출에 사용한 같은 오리진에서 GET /v1/videos/generations/{id}로 전환
    429속도 또는 동시성 제한Retry-After가 있으면 따르고 지터와 함께 백오프
    5xx 또는 클라이언트 시간 초과게이트웨이 또는 업스트림 일시 문제재제출 전에 기존 작업 id를 조회
    status: failed생성이 성공하지 않음error.code와 error.message를 읽기. 정책으로 거부된 본문을 그대로 재시도하지 말 것

    WaitTime=min⁡(MaxWait,BaseInterval×2attempt)+Uniform(0,1)\text{WaitTime} = \min(\text{MaxWait}, \text{BaseInterval} \times 2^{\text{attempt}}) + \text{Uniform}(0, 1)WaitTime=min(MaxWait,BaseInterval×2attempt)+Uniform(0,1)


    5. 요금과 FinOps ROI

    Estimated cost=successful billable jobs×current account rate for that model, duration, and resolution\text{Estimated cost} = \text{successful billable jobs} \times \text{current account rate for that model, duration, and resolution}Estimated cost=successful billable jobs×current account rate for that model, duration, and resolution

    • 호환성이 과금 SKU를 바꾸지는 않습니다. 청구 대상은 전송한 카탈로그 모델 ID(grok-video-1.5 또는 grok-video-1.0)이지 “OpenAI SDK를 사용했다”는 사실이 아닙니다.
    • 기획 초안 단가를 재사용하지 마세요. Grok Video 1.5 레퍼런스는 고정 초당 가격을 보장하지 않습니다. ToAPIs 요금 페이지의 공식 벤더 참고 행은 표시용이며 계정 청구와 다를 수 있습니다.
    • 검색 비용은 낮고 중복 생성 비용은 높습니다. 모델 목록은 짧게 캐시해도 되지만, 클라이언트 시간 초과 후에는 새 작업을 만들기 전에 반드시 상태를 확인하세요.
    • ToAPIs 과금은 보통 사용량 기준입니다. 계정의 현재 조건을 확인하세요.

    6. 자주 묻는 질문

    frontmatter의 FAQ를 보세요. 요약: 호환 오리진이 grok-video-3를 열어 주지는 않습니다. /v1은 한 번만 넣고, /v1/videos/generations/{id}를 폴링하며, SDK videos.create 도우미를 가정하지 말고, 채팅 완성은 MP4를 반환하지 않습니다.


    7. 액션 체크리스트

    • ToAPIs 개발자 포털에서 키를 만듭니다.
    • 클라이언트를 https://api.toapis.com/v1(중국 본토는 https://toapis.cn/v1)로 향하게 하고 Authorization: Bearer를 붙입니다.
    • GET /v1/models?type=video를 호출해 키에 보이는 정확한 Grok Video ID를 기록합니다.
    • grok-video-1.5와 video_generation_mode: "text_to_video"로 POST /v1/videos/generations를 스모크 테스트한 뒤 같은 id를 폴링합니다.
    • 다음: 모드와 이미지 필드 세부 사항은 Grok Video 실습 가이드, 현재 카탈로그는 Grok Video 1.5 모델 가이드.

    본문에서 언급된 모델 및 API

    xAIVIDEO

    grok-video-1.0

    현재 요율:2 credits /second
    모델 가이드콘솔에서 테스트API 키 발급
    xAIVIDEO

    Grok Video 1.5

    현재 요율:3.824 credits /second
    모델 가이드콘솔에서 테스트API 키 발급

    관련 기술 블로그

    tutorial2026-11-17T10:00:00+08:007분 읽기

    Grok-Video-3 API 실습 가이드: xAI 비디오 엔진에서 먼저 확인해야 할 현재 계약

    ToAPIs에서 xAI Grok Video를 호출하는 실습 가이드. 공개 카탈로그에 있는 ID는 grok-video-1.0과 grok-video-1.5이며 grok-video-3가 아닙니다. 현재 generations 계약, 모드, 폴링 경로를 정리합니다.

    TO
    ToAPIs Engineering & Evaluation Team
    #Grok Video
    tutorial2026-11-20T10:00:00+08:009분 읽기

    Alibaba Wan 3.0 비디오 API: 차세대 비디오 생성 시작하기

    ToAPIs에서 wan3.0-video와 wan3.0-video-prime을 다루는 프로덕션 빠른 시작입니다. 하나의 All-in-One 엔드포인트, 첫·끝 프레임과 참조 미디어의 배타 규칙, 파일 또는 링크 참조, 비디오 편집 제약, 문서화된 폴링 경로를 다룹니다.

    TO
    ToAPIs Engineering & Evaluation Team
    #Wan 3.0
    tutorial2026-11-18T10:00:00+08:009분 읽기

    Kling 3.0 Turbo API: 대량 숏폼 비디오 자동화 아키텍처

    ToAPIs에서 kling-3.0-turbo를 프로덕션에 붙이는 가이드입니다. 문서화된 duration과 해상도, 첫 프레임 전용 이미지 입력, 제한된 폴링 루프, 검증되지 않은 초안 가격 없이 고빈도 숏폼을 자동화합니다.

    TO
    ToAPIs Engineering & Evaluation Team
    #Kling Turbo
    ToAPIs
    홈ToAPIs
    엔터프라이즈 AI API 게이트웨이. GPT-5, Claude, Gemini 등 200개 이상의 모델을 하나의 통합 API로 이용하세요.

    인기 모델

    • Seedance 2.5 API
    • Seedance 2.0 API
    • Veo 3.1 Fast API
    • Kling 3.0 Turbo API
    더 보기접기
    • GPT Image 2 API
    • Claude Opus 4.8 API
    • Nano Banana 2 API
    • Seedance 2 Mini API
    • 전체 모델

    API 카테고리

    • AI 이미지 생성 API
    • AI 동영상 생성 API
    • 텍스트 동영상 API
    • 이미지 동영상 API
    더 보기접기
    • AI 이미지 편집 API
    • 언어 및 추론 모델 API
    • 모든 API 도구 →

    대안

    대안
    • Kie.ai 대안
    • Fal.ai 대안
    • OpenRouter 대안
    • Replicate 대안
    • Wavespeed AI 대안
    • 모든 서비스 비교 →

    추천 기술 가이드

    추천 기술 가이드
    • Seedance 2.0과 2.5 가격 비교
    • 저비용 Seedance API 가이드
    • MiniMax H3 연동 가이드
    • Seedance 2 무료 테스트 키
    • Seedance 2 API 빠른 시작
    • 모든 기술 문서 →

    개발자 및 플랫폼

    개발자 및 플랫폼
    • API 문서
    • MCP
    • 요금
    • 모델 플레이그라운드
    • LLMs.txt
    • 지원 문의
    • 모델 가이드 목록
    운영 주체:
    鯨樞智能科技有限公司
    JINGSHU INTELLIGENT LIMITED
    등록 주소:
    ROOM 5042, 5/F, YAU LEE CENTRE, NO.45, HOI YUEN ROAD, KWUN TONG, KOWLOON, HONG KONG
    개인정보처리방침이용약관이용 정책데이터 삭제 정책데이터 보존 정책하위 처리자 및 데이터 리전결제 및 환불쿠키 정책사이트맵소개

    © 2026 ToAPIs. All rights reserved.