이미지 생성
ShareAI 이미지 API를 사용하여 지원되는 모델, 텍스트 프롬프트 및 검증된 이미지 생성 옵션으로 이미지를 생성하세요.
이 페이지에서
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"
}'
Python
import json
import os
import urllib.request
headers = {"Authorization": "Bearer " + os.environ["SHAREAI_API_KEY"]}
headers["Content-Type"] = "application/json"
payload = {'model': 'YOUR_IMAGE_MODEL', 'prompt': 'A quiet forest painted in watercolor.', 'n': 1, 'size': '1024x1024'}
data = json.dumps(payload).encode()
request = urllib.request.Request('https://api.shareai.now/api/v1/images/generations', data=data, headers=headers, method='POST')
with urllib.request.urlopen(request, timeout=180) as response:
print(json.load(response))
TypeScript
const url = "https://api.shareai.now/api/v1/images/generations";
const headers: Record = {
Authorization: `Bearer ${process.env.SHAREAI_API_KEY}`,
};
headers["Content-Type"] = "application/json";
const payload = {
"model": "YOUR_IMAGE_MODEL",
"prompt": "A quiet forest painted in watercolor.",
"n": 1,
"size": "1024x1024"
};
const response = await fetch(url, { method: "POST", headers, body: JSON.stringify(payload) });
if (!response.ok) throw new Error(`${response.status}: ${await response.text()}`);
console.log(await response.json());
요청 필드#
| 필드 | 값 |
|---|---|
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