개발자

라이선스를 받은 실제 모델과 함께 만들어요. Mirai는 렌더링 전에 생성 가능 여부와 모델의 제한 사항을 확인해요.

이용하려면 승인된 계정과 생성 권한이 필요해요.

API 도입 문의 API 문서(영문)
제공 현황

모델 API · 제공 중

참여 모델을 살펴보고, 초안을 생성하고, 승인된 결과물의 라이선스를 구매할 수 있어요. 생성과 상업 라이선스는 별도 단계예요.

API 문서 읽기
빠른 시작

01 · 모델 목록 조회

예약 가능한 모든 모델을, 공개해도 되는 필드만으로 보여줘요.

curl https://mirai.inc/api/v1/models \
  -H "Authorization: Bearer YOUR_KEY"
02 · 초안 생성

모델 목록 응답의 ID를 쓰세요. JSON 결과가 올 때까지 연결을 유지하고, HTTP 200을 받은 뒤에도 error 필드를 확인하세요.

curl -X POST https://mirai.inc/api/v1/generate \
  -H "Authorization: Bearer YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model_id": "MODEL_ID_FROM_ROSTER",
    "prompt": "editorial fashion still, golden hour",
    "format": "portrait"
  }'
03 · 사용 라이선스

승인된 결과물만 결제로 넘어가요. 이미지마다 승인하는 모델의 결과물은 그 승인을 받은 뒤에 라이선스할 수 있어요. 결제하려면 checkout_url을 여세요. 결제를 만드는 것만으로는 라이선스가 활성화되지 않아요.

curl -X POST https://mirai.inc/api/v1/licenses \
  -H "Authorization: Bearer YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "image_ids": ["ASSET_ID"],
    "format": "Digital",
    "duration": "12 months"
  }'
04 · 확인 후 다운로드

결제가 확인되면 결과물 기록을 요청하세요. 인증된 원본 URL은 결과물에 활성 라이선스가 있을 때만 제공돼요. 그 전에는 워터마크가 있는 초안을 계속 쓰세요.

curl https://mirai.inc/api/v1/assets/ASSET_ID \
  -H "Authorization: Bearer YOUR_KEY"
작동 방식

인증

범위가 정해진 Bearer 키.

키에는 읽기, 생성, 라이선스 범위와 키별 사용 한도가 있어요. 계정에서 관리해요.

조건

동의와 라이선스 확인.

생성 가능 여부와 상업 라이선스는 따로 확인해요. 연동할 때는 모델의 제한 사항, 승인 상태, 구매한 범위를 지키고, 사용 전에 최종 결과물을 검토해야 해요.

기록

모든 생성을 기록.

모든 생성에는 ID와 라이선스 상태가 붙어요. 라이선스 받은 파일은 해당 라이선스와 조건으로 연결돼요.

API 도입, 플랫폼 연동, 캐릭터 파일럿은 Mirai 팀에 문의하세요.

API 도입 문의 연동 문의하기
개발자를 위한 라이선스 초상 API | Mirai