APIAI 이미지 생성 API

이미지를 생성하고
같은 호출 흐름에서 마무리하세요

POST 한 번이면 이미지 에이전트(GPT Image, Imagen, Nano Banana, Grok, Leonardo)가 돌아갑니다. 보통 그다음에 오는 누끼, 수정, 리프레임도 같은 키로 한 번의 호출 거리에 있습니다.

POSThttps://autostud.ai/api/v1/actions/images.generate

API 키 받기 API 레퍼런스

세 번의 호출, 프롬프트에서 완성 에셋까지

엔진은 한 번만 고르고, 원하는 만큼 생성한 뒤 파일을 마무리하세요.

이미지 에이전트를 고른다

에이전트는 저장된 설정입니다. 엔진, 크기, 스타일, 그리고 팀이 합의한 프롬프트 템플릿. 워크스페이스의 목록을 불러와 id를 챙기세요.

export AUTOSTUD_API_KEY="sk_live_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"

# An image agent is a saved configuration, not a model name.
curl "https://autostud.ai/api/v1/agents?agent_type=image&limit=10" \
  -H "Authorization: Bearer $AUTOSTUD_API_KEY"

생성한다

프롬프트와 템플릿이 요구하는 변수를 보냅니다. 응답에는 이미지와 소모된 크레딧이 담깁니다.

curl -X POST https://autostud.ai/api/v1/actions/images.generate \
  -H "Authorization: Bearer $AUTOSTUD_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: sku-4471-packshot" \
  -d '{
    "agent_id": "a91d5f27-6c0b-4e83-97aa-2b1e4d70c6f9",
    "prompt": "A ceramic mug seen three-quarter, soft studio light",
    "variables": {
      "product": "ceramic mug",
      "color": "matte navy"
    }
  }'

파일을 마무리한다

배경을 잘라내고, 지시 기반 편집을 적용하고, 다른 포맷으로 리프레임하세요. 같은 키, 같은 원장, 두 번째 연동은 필요 없습니다.

curl -X POST https://autostud.ai/api/v1/actions/tools.remove_background \
  -H "Authorization: Bearer $AUTOSTUD_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "image_url": "https://cdn.autostud.ai/generations/b6c30a19.../image.png"
  }'

보낼 수 있는 것

생성에 세 개의 필드, 후처리에 하나.

agent_id

실행할 이미지 에이전트. 엔진과 크기, 스타일이 함께 따라옵니다.

prompt

무엇을 그릴지, 에이전트 템플릿이 기대하는 방식으로 씁니다.

variables

그 템플릿의 자리표시자에 들어갈 값. 에이전트 하나로 카탈로그 전체를 감당할 수 있습니다.

image_url

마무리 도구용으로, 누끼를 따거나 편집하거나 자를 이미지. 공개적으로 접근 가능하면 무엇이든 됩니다.

엔드포인트 뒤의 엔진들

엔진마다 에이전트로 노출되므로 모델을 바꾸는 일은 다른 id일 뿐 다른 연동이 아닙니다. 새 엔진은 새 에이전트로 나타납니다.

GPT ImageImagenNano BananaGrokLeonardo

그다음에 오는 도구들

생성이 마지막 단계인 경우는 드뭅니다. 배경 제거, 지시 편집, 리프레임은 모두 같은 API의 액션이고 과금 방식도, 키 범위도 같습니다.

tools.remove_backgroundtools.image_modificationtools.image_crop

개발자가 가장 먼저 묻는 것

이미지 하나에 얼마가 들었는지 어떻게 아나요?

모든 응답이 소모 크레딧을 보고하고, 이력은 /api/v1/generations에서 읽을 수 있습니다. 가격은 엔진별이며 워크스페이스에서 설정되고, 요청에는 들어가지 않습니다.

에이전트 하나로 여러 프롬프트를 감당할 수 있나요?

변수가 바로 그 용도입니다. 에이전트가 템플릿과 스타일을 쥐고, 호출이 바뀌는 부분을 채웁니다. 제품 카탈로그는 에이전트 하나와 N번의 호출이지 N개의 에이전트가 아닙니다.

이미지도 웹훅으로 오나요?

generation.completed는 영상이나 오디오와 똑같이 이미지에서도 발생하므로 구독 하나로 생성 계열 전체를 덮습니다.

생성한 이미지를 영상에 쓸 수 있나요?

네. 생성된 URL은 타임라인 레이어에 바로 들어가고, renders.create가 같은 키로 전체 구성을 mp4로 만들어 줍니다.

OpenAPI 명세 에러 코드 API 살펴보기

이제 만들어 볼까요?

바이럴 영상을 몇 분 만에. 무료 체험에는 카드 등록이 필요 없습니다.

무료로 시작하기

또는데모 보기

안전한 결제

즉시 이용

언제든 해지

이미지를 생성하고같은 호출 흐름에서 마무리하세요