문서

API 참조

동기 이미지 생성

POST/v1/images/generations

동기 요청은 모델별로 매개변수를 검증하며 선택한 모델이 지원하는 이미지 기능만 사용할 수 있습니다. Qwen은 최대 이미지 6개/참조 이미지 3개를 지원하고 Ark 제한은 모델마다 다릅니다. Venice 텍스트-이미지 생성은 한 장만 출력하며 참조 이미지를 지원하지 않습니다. 일반 API 파일은 일 단위 저장 정책을 따르며 영구 보관 이미지 작업과 같지 않습니다.

동기 출력의 범위

Qwen은 최대 출력 6개와 참조 이미지 3개를 지원하고 Ark의 제한은 모델에 따라 다르며 Venice는 단일 이미지 텍스트-이미지 생성만 제공합니다. 먼저 모델을 선택한 뒤 해당 필드를 보내세요. 참조 이미지를 지원하지 않는 모델에 참조 이미지 요청을 보내지 마세요.

견적 확인, 장기 기록과 연결 중단 복구가 필요하면 동기 생성 요청을 자동 반복하지 말고 영구 보관 이미지 워크플로를 사용하세요. 동기 응답의 파일 보관 헤더는 저장 단계만 설명합니다. 일반 파일 보관과 작업 참조 보호는 서로 다릅니다. 요금을 참고하세요.

인증과 권한

현재 GloopAPI 키를 사용하세요. 사용 가능한 모델, 기능과 권한은 해당 카탈로그와 엔드포인트 문서에 따라 달라집니다.

Authorization: Bearer $GLOOP_API_KEY

인증 방식: BearerAuth

요청

요청 본문 · application/json

유형
object
필수 필드
modelprompt

요청 본문 필수

  • image_urlsarray선택 사항

    모델별 참조 이미지 URL 목록입니다. Qwen/Ark에는 각각의 제한이 있으며 Venice 동기 텍스트-이미지 생성은 이 필드를 거부합니다.

    image_urls 하위 필드(1)
    • []string선택 사항
  • modelstring필수

    현재 키의 카탈로그에 있는 공개 모델 ID입니다.

  • promptstring필수

    생성 프롬프트입니다.

  • ninteger선택 사항

    요청한 출력 이미지 수이며 선택한 모델의 최댓값을 계속 적용합니다.

  • sizestring선택 사항

    선택한 image-models 항목이 반환한 크기 값이며 기능과 크기는 모델별로 검증합니다.

  • response_formatstring선택 사항

    모델별 출력 형식입니다. 모든 모델이 모든 형식을 지원한다고 가정하지 마세요.

  • userunknown선택 사항

    선택한 도구의 스키마 또는 프로토콜이 정의하는 JSON 값입니다. 고정 필드를 가정하지 마세요.

  • extra_bodyunknown선택 사항

    선택한 도구의 스키마 또는 프로토콜이 정의하는 JSON 값입니다. 고정 필드를 가정하지 마세요.

응답과 오류

HTTP 200

동기 이미지 생성 성공

application/json

유형
object
필수 필드
createddata
  • createdinteger필수

    Unix 초 단위 이미지 응답 생성 시각입니다.

  • dataarray필수

    현재 페이지/카탈로그의 데이터 배열입니다.

    data 하위 필드(1)
    • []object선택 사항
      [] 하위 필드(7)
      • file_idstring선택 사항

        동일 계정/키의 관리형 파일 공개 ID입니다.

      • storage_statusstring선택 사항

        파일 보관 상태이며 관리형 다운로드는 ready 이후에만 보장됩니다.

      • storage_errorstring선택 사항

        파일 보관 실패의 공개 분류입니다.

      • expires_atinteger선택 사항

        Unix 초 단위 만료 시각이며 0은 고정 만료 시각이 없음을 뜻합니다.

      • urlstring선택 사항

        결과 또는 참조의 접근 URL입니다. 서명 URL은 짧은 시간 동안만 유효합니다.

      • b64_jsonstring선택 사항

        이미지 Base64 문자열입니다. URL로 요청하지 마세요.

      • revised_promptstring선택 사항

        서비스이 반환한 수정된 프롬프트가 있는 경우 해당 값입니다.

HTTP 400

요청 필드 또는 매개변수가 유효하지 않습니다.

application/json

유형
object
필수 필드
error

HTTP 401

키가 없거나 유효하지 않거나 만료 또는 폐기되었습니다.

application/json

유형
object
필수 필드
error

HTTP 403

IP, 계정, 모델 또는 도구 권한이 부족합니다.

application/json

유형
object
필수 필드
error

HTTP 404

객체/기능을 사용할 수 없거나 기능 스위치가 비활성화되었습니다.

application/json

유형
object
필수 필드
error

HTTP 409

멱등성/견적 충돌, 준비되지 않은 객체 또는 여전히 참조 중인 상태입니다.

application/json

유형
object
필수 필드
error

HTTP 429

요청/대기열 속도 제한입니다.

application/json

유형
object
필수 필드
error

HTTP 500

내부 인증 또는 데이터 저장 오류입니다.

application/json

유형
object
필수 필드
error

HTTP 503

서비스, 가격 또는 스토리지를 사용할 수 없습니다.

application/json

유형
object
필수 필드
error
개발할 준비가 되셨나요? 열기: 콘솔 API 키를 생성하거나 살펴보기: 기능.