이미지 생성
동기 JSON 응답에는 데이터에 이미지 결과가 포함됩니다.
이 페이지에서
https://api.shareai.now/api/v1/images이미지 생성
- 기본 URL
https://api.shareai.now- 인증
- Bearer API 키 또는 승인된 OAuth 액세스 토큰
- 필수 범위
inferenceormonetization_gateway
동기 JSON 응답에는 이미지 결과가 포함됩니다. data. 별칭 /api/v1/images/generations 도 지원됩니다. 크기, 해상도, aspect_ratio, 품질 및 출력 형식과 같은 옵션은 선택한 모델에 따라 달라집니다. 응답은 2 MiB로 제한되며, 필요 시 이미지 수나 크기를 줄이십시오. 반환된 이미지는 한 변당 최대 8192픽셀로 제한됩니다.
시작하기 전에#
서버에서 SHAREAI_API_KEY를 설정하고 모델 자리 표시자를 현재 활성화된 모델로 교체하세요. API 키를 브라우저 코드에 노출하지 마세요. 모델, 계정, 자격 증명 및 제공자가 모두 이 작업을 허용해야 합니다. 아래의 선택적 설정은 모델 지원이 필요합니다. API 안전 한도는 모든 모델이 모든 값을 지원한다는 보장이 아닙니다.
요청 보내기#
cURL
curl --fail-with-body --request POST "https://api.shareai.now/api/v1/images" \
-H "Authorization: Bearer $SHAREAI_API_KEY" \
-H "Content-Type: application/json" \
--data '{
"model": "YOUR_ENABLED_IMAGES_MODEL",
"prompt": "A quiet forest painted in watercolor.",
"n": 1
}'Python
import json
import os
import urllib.request
payload = {'model': 'YOUR_ENABLED_IMAGES_MODEL',
'prompt': 'A quiet forest painted in watercolor.',
'n': 1}
headers = {'Content-Type': 'application/json'}
headers["Authorization"] = "Bearer " + os.environ["SHAREAI_API_KEY"]
request = urllib.request.Request('https://api.shareai.now/api/v1/images', data=json.dumps(payload).encode(), headers=headers, method="POST")
with urllib.request.urlopen(request, timeout=180) as response:
result = json.load(response)
print(result)TypeScript
const response = await fetch("https://api.shareai.now/api/v1/images", {
method: "POST",
headers: { Authorization: `Bearer ${process.env.SHAREAI_API_KEY}`, ...{"Content-Type": "application/json"} },
body: JSON.stringify({
"model": "YOUR_ENABLED_IMAGES_MODEL",
"prompt": "A quiet forest painted in watercolor.",
"n": 1
}),
});
if (!response.ok) throw new Error(await response.text());
const result = await response.json();
console.log(result);요청 필드#
| 필드 | 유형 | 의미와 제한 |
|---|---|---|
model 필수 | 문자열 | 정확히 활성화된 공개 모델 식별자. 이 작업을 선언하고 귀하의 자격 증명으로 허용되어야 합니다. |
prompt 필수 | 문자열 | 비어 있지 않은 생성 프롬프트, 최대 256 KiB의 UTF-8 텍스트. |
n | 정수 | 선택적 이미지 수, 1–10; 기본값은 1입니다. 사용 중인 모델에 따라 더 적은 수를 허용할 수 있습니다. |
size | 문자열 | 모델 지원 출력 크기, 최대 100자, 예: 1024×1024. 모든 모델이 이 옵션을 지원하는 것은 아닙니다. |
resolution | 문자열 | 모델 지원 해상도 선택기, 최대 100자; 게시된 요금제 변형과 일치해야 합니다. |
aspect_ratio | 문자열 | 모델 지원 화면 비율 선택기, 최대 100자. |
quality | 문자열 | 모델에서 지원하는 품질 선택기, 최대 100자; 다른 비율을 선택할 수 있습니다. |
response_format | 문자열 | 모델이 지원하는 응답 형식, 최대 100자. 작업에 따라 결과가 JSON 또는 바이너리인지 결정됩니다. |
output_format | 문자열 | 모델에서 지원하는 출력 인코딩 선택기, 최대 100자. |
background | 문자열 | 모델에서 지원되는 경우 선택적으로 이미지 배경 설정 가능. |
seed | 정수 | 선택적 모델 지원 시드. 비디오는 0 이상의 정수를 요구하며, 재현 가능성은 실행자에 따라 달라집니다. |
input_references | 배열 | 최대 16개의 유형화된 image_url 부분, image_url.url이 HTTPS URL 또는 지원되는 이미지 데이터 URL로 설정됩니다. 모델 지원이 필요합니다. |
provider | 객체 | 선택적 공급자 라우팅 선호도. 모델 ID의 접두사가 아닌, 허용된 공급자 태그에 대해 provider.only를 사용하십시오. 계정 및 자격 증명 제한은 여전히 적용됩니다. |
결과 읽기#
성공 시 HTTP 200과 JSON을 반환합니다. 동기 JSON 응답에는 이미지 결과가 포함됩니다. data. 별칭 /api/v1/images/generations 도 지원됩니다. 크기, 해상도, aspect_ratio, 품질 및 출력 형식과 같은 옵션은 선택한 모델에 따라 달라집니다. 응답은 2 MiB로 제한되며, 필요 시 이미지 수나 크기를 줄이십시오. 반환된 이미지는 한 변당 최대 8192픽셀로 제한됩니다.
청구 단위#
이미지 요금은 생성된 이미지, 측정된 메가픽셀, 입력 참조, 요청 또는 제공자가 보고한 토큰을 기준으로 사용할 수 있습니다. 이미지 URL은 이미지 크기 측정값이 아닙니다. 메가픽셀 요금은 반환된 이미지의 크기가 필요하며, 해당 경로에서는 base64 출력을 사용하십시오.
Console에서 정확히 활성화된 모델 식별자를 선택하세요. 선언된 작업 및 입출력 기능이 이 엔드포인트와 일치해야 합니다. 텍스트 채팅 모델은 다른 작업으로 대체될 수 없습니다. 자격 증명, 제공자 및 계정 제한은 여전히 적용됩니다.
가격 및 사용량#
요금은 선택된 모델, 제공자, 단위 및 변형에 대해 EUR AI 크레딧으로 게시됩니다. 활성 요금제의 차원만 청구됩니다. 실행 전에 크레딧을 예약하는 견적이 제공되며, 최종 청구는 측정된 사용량을 기준으로 합니다. 가격은 해상도, 출력 형식 또는 사용량 대역에 따라 달라질 수 있습니다. 최종 ShareAI 차감액은 Console Usage에서 확인하세요. 상류 비용 필드와 미디어 바이트는 발명된 토큰 수로 변환되지 않습니다.
접근 및 오류#
사용 inference 승인된 네트워크 비용 추론의 경우 monetization_gateway 승인된 Builder 마크업 및 수락된 청구 조건의 경우. 신원 확인만으로는 지출이 승인되지 않습니다. 유효성 검사, 모델 승인, 크레딧 부족, 속도 제한 및 실행 실패는 구조화된 error. 를 반환합니다. 타임아웃 또는 불확실한 제출 후에는 또 다른 잠재적으로 유료 요청을 생성하기 전에 Usage 또는 비디오 작업을 확인하세요.
마지막 업데이트 2026년 11월 3일