정적 자산은 이미지 API
한 장의 결과와 해상도, 참조 수 또는 품질이 중요하면 이미지 모델을 사용합니다.
Imya는 이미지·동영상 생성, 작업 조회, 실시간 크레딧 과금과 결과 자산을 하나의 API 계층에서 제공합니다. GPT Image 2, Seedream 5.0 Pro, Hailuo 2.3, Seedance 2.0의 개발자 미리보기 계약을 이곳에서 확인할 수 있습니다.
각 모델 문서에서 호출 가능한 엔드포인트, 공개 파라미터, 실시간 과금 응답과 작업 수명 주기를 확인하세요.
텍스트 생성과 참조 이미지 워크플로, 해상도별 크레딧과 작업 조회를 지원합니다.
텍스트와 최대 10장의 참조 이미지로 생성하며 비율, 품질, 출력 형식을 제어합니다.
텍스트·이미지 기반 동영상 생성과 낮은 지연 시간의 Fast 변형을 지원합니다.
텍스트·이미지 기반 동영상에서 길이, 해상도, 화면 비율과 오디오를 제어합니다.
설정에서 API Key를 생성합니다.
model과 prompt로 생성 요청을 보냅니다.
성공 또는 실패할 때까지 작업 엔드포인트를 조회합니다.
반환된 이미지 또는 동영상 URL을 앱에 저장합니다.
AI 모델 API 연동 가이드
제품이 반환할 미디어가 이미지인지 동영상인지 먼저 결정하고 실제로 필요한 제어 항목을 선택하세요. Imya의 네 모델은 같은 인증과 비동기 작업 패턴을 사용하므로 공통 인프라를 재사용할 수 있습니다.
한 장의 결과와 해상도, 참조 수 또는 품질이 중요하면 이미지 모델을 사용합니다.
동영상이 필요하면 텍스트 또는 시작 이미지, 길이와 해상도를 결정하고 별도 동시 실행 큐를 준비합니다.
모델별 문서를 요청 필드의 기준으로 삼고 정확한 과금은 응답의 credits_reserved를 사용하세요.
프롬프트 또는 최대 16장의 참조 이미지, 1K·2K·4K 출력이 필요한 이미지 작업에 적합합니다.
GPT Image 2 API 문서 읽기최대 10장의 참조와 basic·high 품질이 필요한 이미지 작업에 적합합니다.
Seedream 5.0 Pro API 문서 읽기6초 또는 10초의 텍스트·이미지 기반 동영상과 Standard·Fast 변형에 적합합니다.
Hailuo 2.3 API 문서 읽기480p·720p·1080p, 4~15초의 텍스트·이미지 기반 동영상에 적합합니다.
Seedance 2.0 API 문서 읽기API Key를 브라우저 밖에 두고 백엔드에서 생성, 조회, 과금 기록과 사용자 상태를 통합하세요.
Bearer 토큰과 논리 생성마다 고유한 Idempotency-Key를 보내 동일 본문의 네트워크 재시도가 중복 작업이나 과금을 만들지 않게 합니다.
작업 접수 시 credits_reserved가 원자적으로 차감됩니다. 클라이언트에 가격표를 복제하지 말고 반환 값을 기록하세요.
id를 저장하고 GET /v1/tasks/{id}를 5초 이상 간격으로 pending, processing, succeeded 또는 failed까지 조회합니다.
30분 뒤 미완료 작업은 failed가 됩니다. refund_pending은 결제 처리 중이며 credits_refunded가 한 번의 환불 완료를 확인합니다.
실제 사용자 트래픽을 보내기 전에 다음 제어를 완료하세요.
네 모델에 공통으로 적용되는 답변입니다.
첫 사용자 흐름이 요구하는 미디어를 만드는 한 모델부터 시작하고 작업 수명 주기가 안정된 뒤 두 번째 모델을 추가하세요.
예. 동일한 Idempotency-Key와 본문을 재사용하면 중복 과금 없이 원래 작업을 반환합니다.
새 작업 접수 시 credits_reserved를 차감하고 대상 실패 시 원래 만료일을 유지해 한 번만 환불합니다.
무료 계정 7일, 활성 유료 또는 Lifetime 계정 최대 30일입니다. 필요한 자산은 기간 안에 복사하세요.
첫 사용 사례에 가장 가까운 문서를 열고 생성·조회·결과 흐름을 완성한 뒤 다른 모델을 추가하세요.