레퍼런스v1.0.0 안정 버전

AI Video to Prompt API 안내

고성능 AI 이미지 생성 기능을 서비스에 통합할 수 있습니다. 이 문서는 완전한 API 레퍼런스, 연동 가이드, 코드 예제를 제공하여 개발자가 빠르게 AI 이미지 애플리케이션을 구축할 수 있도록 돕습니다.

https://aivideotoprompt.com
01

퀵 스타트

생성 작업을 제출하고 상태를 폴링하는 두 단계만으로 첫 번째 API 호출을 완료할 수 있습니다.

1

작업 제출

POST 요청을 generate 엔드포인트로 보내 Task ID를 받습니다.

2

상태 조회

Task ID를 사용해 진행 상황을 확인하고, 이미지 URL이 반환될 때까지 조회합니다.

02

인증

주의: API 키는 안전하게 보관하고, 클라이언트 사이드 코드에 노출하지 마세요.

HTTP 헤더
Authorization: Bearer {YOUR_API_KEY}
POST
https://aivideotoprompt.com/api/generate

새 이미지 생성 작업을 만들어요. 이 엔드포인트는 비동기로 작동하며 task_id와 초기 상태를 반환해요. 최종 이미지는 /api/status를 호출해 가져오세요.

이 엔드포인트는 task_id를 즉시 반환해요. 상태가 SUCCESS가 될 때까지 /api/status를 주기적으로 조회하면 이미지 URL을 받을 수 있어요.

본문 파라미터

파라미터 이름타입필수 여부설명
promptstring필수생성에 사용할 텍스트 프롬프트(최대 1000자).
aspect_ratiostring필수생성할 이미지의 가로세로 비율이에요. 허용 값: 1:1, 4:3, 3:4, 16:9, 9:16.
응답(JSON)
{
  "code": 200,
  "message": "success",
  "data": {
    "task_id": "task_1234567890",
    "status": "IN_PROGRESS"
  }
}
GET
https://aivideotoprompt.com/api/status

작업의 실행 상태와 결과를 조회합니다.

쿼리 파라미터

파라미터 이름필수 여부설명
task_id필수작업을 제출할 때 반환된 ID입니다.
응답 예시
{
  "code": 200,
  "message": "success",
  "data": {
    "status": "SUCCESS",
    "task_id": "xxxxxxxx",
    "request": {
      "prompt": "A beautiful sunset over mountains",
      "aspect_ratio": "16:9"
    },
    "response": [
      "https://cdn.example.com/images/task_xxx_0.jpeg"
    ],
    "consumed_credits": 15,
    "created_at": "2025-12-05 13:05:09",
    "error_message": null
  }
}

결제

요청당 비용

$0.02 / 요청

실패한 작업에는 비용이 청구되지 않습니다.

오류 처리

  • 401 인증 필요유효하지 않은 API 키입니다.
  • 402 결제 필요잔액이 부족합니다.
  • 429 요청 과다요청 한도에 도달했습니다.
03

AI Video to Prompt 소개

AI Video to Prompt는 업로드한 참고 동영상을 타임코드가 포함된 샷 목록과 편집 가능한 프롬프트로 바꿔줘요. 선택한 동영상 모델에 맞게 샷을 조정하거나 피사체를 바꾸고, 동영상 작업 공간에서 새 버전을 생성하세요. 이미지 도구도 정지 이미지를 프롬프트로 바꾼 뒤 작업 공간으로 전달하는 같은 흐름을 제공해요.

Z-Image-Turbo — 60억 파라미터의 초고속 텍스트-투-이미지 모델

Z-Image-Turbo는 Tongyi-MAI에서 개발한 60억 파라미터 텍스트-투-이미지 모델로, 레이턴시와 처리량이 중요한 프로덕션 워크로드에 맞춰 설계되었습니다. 단 8 스텝 샘플링만으로 전체 이미지를 렌더링하며, 데이터센터 GPU에서 1초 미만의 지연을 달성하고, 많은 16 GB VRAM 소비자용 카드에서도 안정적으로 동작합니다.

프로덕션 품질의 초고속 이미지 생성

많은 확산 모델이 수십 스텝을 필요로 하는 반면, Z-Image-Turbo는 8스텝 샘플러에 공격적으로 최적화되어 있습니다. 이를 통해 매우 빠른 추론 속도를 유지하면서도 포토리얼 이미지와 신뢰할 수 있는 온이미지 텍스트를 제공하여, 대시보드, 인터랙티브 제품, 대규모 백엔드 등 배치 작업뿐 아니라 다양한 실시간 서비스에도 적합합니다.

왜 이렇게 잘 나올까요?

  • 속도와 포토리얼리즘 동시 제공 — 여러 초를 기다릴 필요 없이, 상품 사진, 히어로 배너, UI 비주얼 등에 사용할 수 있는 고품질·고해상도 이미지를 생성합니다.
  • 이중언어 프롬프트와 텍스트 — 영어와 중국어 프롬프트를 이해하고, 이미지 안에 다국어 텍스트를 직접 렌더링할 수 있어, 크로스 마켓 캠페인, 포스터, 스크린샷에 유용합니다.
  • 저지연·저스텝 구조 — 이미지당 8번의 함수 평가만으로 매우 낮은 지연을 제공하여, 챗봇, 구성 도구, 디자인 어시스턴트 등 ‘클릭 → 이미지’ 경험에 최적입니다.
  • VRAM 친화적인 메모리 사용 — 16 GB VRAM 환경에서도 원활하게 실행되며, 로컬 또는 엣지 배포를 보다 현실적인 옵션으로 만듭니다.
  • 대량 생성에 최적화 — 높은 효율 덕분에 카탈로그, 지속 피드 이미지, 자동 생성 썸네일 등 대규모 작업도 컴퓨트 예산을 크게 늘리지 않고 실행할 수 있습니다.
  • 재현 가능한 생성 — 제어 가능한 seed 파라미터를 통해 이전 이미지를 다시 생성하거나, 브랜드 세이프티와 실험을 위한 작은 변형 이미지를 만들 수 있습니다.

사용 방법

  • promptprompt – 장면, 스타일, 이미지 안의 텍스트(영어 또는 중국어)를 포함한 자연어 설명입니다.
  • sizesize (가로 / 세로) – 출력 해상도를 선택합니다. 1536×1536과 같은 고해상도 정사각형·직사각형 이미지를 지원합니다.
  • seedseed – 무작위 결과가 필요하면 -1로 설정하고, 동일한 출력을 다시 얻고 싶다면 고정된 정수 값을 사용하세요.
이미지 생성 작업 공간이미지 프롬프트 변환

© AI Video to Prompt. 모든 권리 보유.