이미지: 비동기 작업

#요청 파라미터

• modelstring필수

  비동기 이미지 모델 ID(예: gpt-image-2). 동기 전용 모델은 이 엔드포인트를 거부합니다.

• promptstring필수

  그릴 내용.

• sizestring선택

  화면 비율 프리셋(예: "16:9"). 대부분의 이미지 모델이 이 형식을 사용하며, 정확한 값은 모델 카드에 나와 있습니다. 일부 구형 모델은 WIDTHxHEIGHT도 받습니다.

• resolutionstring선택

  출력 해상도 구간(예: "1K", "2K", "4K"). 모델 카드에 나와 있을 때 지정할 수 있습니다 — 요금 구간 기준이기도 합니다.

• qualitystring선택

  제공업체 품질 수준(예: standard / hd) — 요금 구간 기준이기도 합니다.

• ninteger선택

  이미지 수(이미지 수만큼 과금이 곱해집니다).

• imagesarray선택

  편집하거나 참고할 이미지로, URL 또는 data URI로 넣습니다. 모델마다 받는 개수는 모델 카드에서 확인하세요.

• maskstring선택

  첫 번째 참고 이미지의 한 부분만 다시 그립니다. 아래 "이미지 일부만 편집"을 참고하세요. 모델 카드에 mask가 있는 모델만 받으며, mask_url로 써도 같습니다.

• webhook_urlstring선택

  작업이 최종 상태에 도달하면 호출되는 HTTPS URL — 콜백 규약은 동영상 가이드를 참고하세요.

• webhook_secretstring선택

  설정하면 전송에 X-Xiaoxiang-Signature: sha256=hex(HMAC-SHA256(body, secret))가 포함됩니다.

#이미지 일부만 편집

images에 원본 이미지를 넣고 mask를 함께 보내면 마스크로 지정한 부분만 다시 그리고 나머지는 그대로 둡니다. 그 부분에 무엇이 들어갈지는 prompt에 쓰세요. 현재 gpt-image-2.5-flare와 gpt-image-2.5-sunburst가 mask를 지원하며, 모델 카드에는 mask 필드로 표시됩니다.

curl https://www.aisplice.store/v1/images/tasks \
  -H "Authorization: Bearer sk-YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-image-2.5-flare",
    "prompt": "Replace the mug with a glass of orange juice; keep everything else",
    "images": ["https://example.com/desk.png"],
    "mask": "https://example.com/desk-mask.png",
    "resolution": "1K"
  }'

#관련 오류