네 가지 프로그래밍 언어의 실행 예제

워크플로 선택

각 예제는 현재 모델 조회, 생성 전 견적, 비공개 상태 저장, 같은 작업 조회, 실제 출력 바이트 저장을 수행합니다. 프로덕션 SDK가 아닌 학습 예제입니다. 다운로드 후 실행 전에 코드를 검토하세요.

먼저 전체 예제 README와 API 빠른 시작을 읽으세요. 정확한 매개변수는 API 레퍼런스를 따릅니다.

유료 작업 없이 준비

ANIMGEN_API_KEY를 비공개로 보관하세요. IMAGE_PATH에 이미지 경로, ANIMGEN_MODEL에 GET /v1/models의 ID를 설정하세요. TypeScript·cURL·C# 첫 실행에는 ANIMGEN_APPROVE_CREDITS를 설정하지 마세요. 인증 계정이 필요하며 생성에는 충분한 크레딧도 필요합니다.

언어에 맞는 명령 하나만 선택하세요.

# TypeScript
node --experimental-strip-types typescript.ts

# cURL
bash curl.sh

# C#: keep both downloads in the same isolated directory
dotnet build AnimGenPublicApiExample.csproj
dotnet run --project AnimGenPublicApiExample.csproj

Python은 빠른 시작의 별도 prepare·run을 사용하세요. 나머지는 견적 표시 후 멈추며, 명시적으로 동의한 금액을 ANIMGEN_APPROVE_CREDITS에 설정한 뒤 같은 저장 상태로 동일 명령을 다시 실행해야 합니다.

상태를 비공개로 유지하고 같은 작업 복구

TypeScript·C#은 ANIMGEN_STATE(기본 animgen-state.json), cURL은 ANIMGEN_STATE_DIR(기본 animgen-curl-state), Python은 --state를 사용합니다. 형식이 다르므로 재시도 중 구현을 바꾸지 마세요. 상태당 프로세스 하나만 실행하세요.

상태에는 입력 이미지·프롬프트가 포함되므로 버전 관리 밖의 비공개 디렉터리에 보관하세요. 계정·API 키 ID는 저장하지만 비밀 키는 저장하지 않습니다. Windows ACL은 직접 제한하세요. TypeScript·C#·cURL의 다운로드 디렉터리는 ANIMGEN_OUTPUT, Python은 --output으로 정합니다.

불확실한 생성 후에는 정확한 상태, 계정, 원래 API 키 식별, 본문, 멱등 키를 유지하세요. 키 변경은 서버 멱등성 범위를 바꿉니다. 예제는 미해결 생성의 자동 복구를 24시간 후 중단합니다. 로컬 시간 초과는 원격 취소가 아닙니다.

작업 ID 저장 후 재실행은 새 생성 대신 같은 작업을 조회합니다. 실패·취소에도 에셋이 있으면 저장한 뒤 0이 아닌 종료 코드로 미완료를 보고합니다. 서명 다운로드에는 API Authorization 헤더를 보내지 않으며 만료 링크는 에셋 메타데이터로 갱신합니다.

테스트 범위

Python·TypeScript·cURL은 모의 환경에서 견적 전용 준비, 승인된 생성, 안정적인 상태, 조회, 부분 다운로드를 검증합니다. Python·TypeScript는 생성 응답 손실 후 원래 키로 재시도하는 경우도 검증합니다. 문서 검증에는 유료 제공업체 호출이 없습니다. C#은 문법만 검증했으므로 실제 사용 전 .NET 8에서 빌드·검토하세요.

예제를 수정할 때 오류 및 재시도, 상태 조회 및 다운로드를 참고하세요.