ShareAI Platform Docs

이미지 생성

ShareAI 이미지 API를 사용하여 지원되는 모델, 텍스트 프롬프트 및 검증된 이미지 생성 옵션으로 이미지를 생성하세요.

Markdown으로 보기
이 페이지에서
POST https://api.shareai.now/api/v1/images/generations

텍스트 프롬프트에서 이미지를 생성하세요.

기본 URL
https://api.shareai.now
인증
Bearer API 키 또는 승인된 OAuth 액세스 토큰

ShareAI에서 현재 활성화된 이미지 모델을 사용하고 자격 증명으로 허용된 모델을 사용하세요. 모델은 지원하는 크기, 품질 수준 및 출력 옵션을 결정합니다.

요청 보내기#

cURL

curl --fail-with-body --request POST \
  "https://api.shareai.now/api/v1/images/generations" \
  -H "Authorization: Bearer $SHAREAI_API_KEY" \
  -H "Content-Type: application/json" \
  --data '{
  "model": "YOUR_IMAGE_MODEL",
  "prompt": "A quiet forest painted in watercolor.",
  "n": 1,
  "size": "1024x1024"
}'

요청 필드#

필드
model활성화된 이미지 생성 모델 ID.
prompt비어 있지 않은 텍스트 설명.
n모델 지원에 따라 1에서 10까지의 이미지 수.
size / quality선택적 모델 지원 크기 및 품질 값.
response_format / output_format선택적 모델 지원 응답 및 파일 형식 설정.
background모델에서 지원하는 선택적 배경 설정.

이미지를 읽기#

반환된 data 항목을 검사하세요. 모델 및 요청된 형식에 따라 항목에는 HTTPS 이미지 URL 또는 base64 이미지 데이터가 포함됩니다. 실제 반환된 형식을 사용하세요. 모든 제공자가 URL을 반환한다고 가정하지 마세요. API는 반환된 이미지 URL을 다운로드하지 않습니다.

크기 및 시간 제한#

요청은 동기식입니다. 결합된 텍스트는 256 KiB로 제한되며, 제공자 호출은 120초, 응답은 2 MiB로 제한됩니다. 큰 base64 이미지는 해당 응답 제한을 초과할 수 있습니다. 적합한 출력 크기를 선택하거나 URL 출력을 지원하는 모델을 선택하세요.

신중하게 재시도#

이미지를 생성하면 사용량이 발생할 수 있습니다. 시간 초과 또는 모호한 네트워크 오류 후에는 활동을 확인한 후 재시도하세요. 요청을 반복하면 추가 이미지를 생성하고 비용이 청구될 수 있습니다. API는 제공자에게 제출된 이미지 요청을 자동으로 재시도하지 않습니다.

지원되는 작업#

이 경로는 텍스트에서 이미지를 생성합니다. 이미지 편집, 변형, 다중 부분 업로드 및 스트리밍 이미지 생성은 지원되지 않습니다. 현재 청구는 호환 가능한 모델/제공자 토큰 사용 계약을 요구하며, 이미지 단위 제공자는 사용할 수 없을 수 있습니다.

고객 인증 사용#

승인된 OAuth 흐름을 위해 액세스 토큰을 Bearer로 전송하세요. 계정 자금으로 지원되는 이미지 생성에는 surcharge 및 승인된 사용 계획이 필요합니다. 모든 모델, 제공자 및 계정 제한은 계속 적용됩니다.

마지막 업데이트 9월 15, 2026

ShareAI 플랫폼 문서
모든 문서

제목 또는 내용으로 검색하세요.

이 페이지에 대해 문의하기

이 페이지를 탐색할 도우미를 선택하세요. 페이지를 복사하여 대화에 붙여넣을 수도 있습니다.

Ask ChatGPTAsk ClaudeAsk GrokAsk ShareAI