OpenAI: DALL·E 3

DALL·E 3은 텍스트로 작성한 장면 작업 지시를 바탕으로 이미지를 생성합니다. 이미지 생성 메서드에서 정확한 모델 ID openai/dall-e-3 또는 별칭 dall-e-3을 사용한 뒤, 반환된 모든 이미지 URL과 함께 제공된 결과를 저장하세요. 문서의 시작 요청은 텍스트로 1024x1024 이미지 한 장을 만듭니다.

Ailoot Ultra · Images POST /v1/images/generations openai/dall-e-3
Ailoot Ultra · Images POST /v1/images/generations dall-e-3

모델 소개

이 설명은 모델의 기능을 다룹니다. Ailoot에서 사용할 수 있는 입력, 출력 및 옵션은 아래에 선택한 메서드별로 표시됩니다.

DALL·E 3은 OpenAI의 텍스트 이미지 생성 모델입니다. 텍스트로 작성한 작업 지시로 일러스트, 장면 콘셉트, 디자인의 시각적 방향을 만드세요. 프롬프트에 피사체, 환경, 구도, 조명, 표현 방식을 설명하세요. 예를 들어 콘셉트 작업 지시로는 해 질 무렵 작은 가게 옆의 배달 자전거를 길에서 바라보는 모습에 명확한 전경 피사체와 절제된 색상 팔레트를 요청할 수 있습니다.

application/json 본문으로 POST /v1/images/generations를 보내세요. 정확한 공개 모델 ID는 openai/dall-e-3이며, 허용된 별칭 dall-e-3도 같은 모델 카드를 선택합니다. 문서의 시작 형태는 model, prompt, n:1, size:"1024x1024"를 제공합니다. n은 선택 정수이며 기본값은 1입니다. 완전한 JSON 결과에는 stream:false를 보내거나 stream을 생략하세요. 비어 있지 않은 텍스트 prompt를 사용하고, 이 요청에는 하나의 완전한 이미지 작업 지시만 담으세요. 제공되는 메서드는 텍스트 이미지 생성입니다.

배치에 중요한 요구 사항을 명시하세요. 편집용 일러스트에서는 핵심 생각과 이를 표현하는 물체를 지정할 수 있습니다. 장면 콘셉트에서는 카메라 위치, 시간대, 주변에 여백이 필요한 구도 부분을 지정할 수 있습니다. 이미지에 반드시 들어가야 할 정확한 문구는 장면 설명과 구분하고, 선택한 결과를 사용하기 전에 이미지에 그려진 글자와 시각적 배치를 검사하세요.

생성 응답은 created 타임스탬프와 data 배열이 있는 JSON입니다. 문서의 결과 항목에는 url이 포함되며 revised_prompt, prompt_filter_results, content_filter_results가 포함될 수도 있습니다. 이 필드를 완전한 응답과 함께 보존하고, 반환된 모든 서명된 Ailoot URL에서 이미지를 다운로드하세요. Ailoot 서명 파일 링크는 발급 후 24시간 동안 유효합니다. 파일이 저장될 때까지 쿼리 문자열을 포함한 정확한 반환 URL을 보관하세요. 저장된 이미지 형식은 실제 응답이나 파일 바이트로 판별하세요.

반환된 이미지 파일은 사용할 디자인 자산으로, JSON은 함께 제공된 생성 기록으로 취급하세요. 페이지, 프레젠테이션, 애플리케이션에 넣기 전에 이미지를 제공한 작업 지시와 대조해 검토하세요. 응답이 불완전하거나 전송 결과가 불확실하다면 기존 시도를 확인하는 동안 원래 요청 식별자와 반환된 정보를 보관하세요. 누락된 결과를 복구하려는 이유만으로 다른 이미지를 만들지 마세요. 저장된 결과를 가져오려면 같은 API 키로 GET /v1/media/assets?family=image를 호출하고 모든 next_cursor를 따라가세요. 자산 ID는 반환된 각 /v1/media/assets/{asset_id}/content URL과 해당 미디어 라이브러리 기록에 나타납니다. 선택한 각 기록에 대해 GET /v1/media/assets/{asset_id}를 읽고 정확한 content_url에서 다운로드하세요. 파일 요청이 code link_expired와 함께 404를 반환하면 같은 자산을 다시 읽어 갱신된 링크를 얻으세요. 자산 링크 갱신에는 다른 이미지 생성 요청이 필요하지 않습니다.

Ailoot Ultra · Images POST /v1/images/generations openai/dall-e-3

openai/dall-e-3

OpenAI /openai/dall-e-3

모델 ID

openai/dall-e-3
dall-e-3

시작하기

허용 입력: 텍스트
결과: 이미지

Ailoot에서 사용 가능 · 입력 및 메서드

Ailoot Ultra · Images POST /v1/images/generations

입력: text
출력: image
출력 형식: 이미지 파일

필드	유형	요건	값과 한도	기본값
필드`model`	유형`string`	요건필수	값과 한도 openai/dall-e-3	기본값—
필드`prompt`	유형`string`	요건필수	값과 한도	기본값—
필드`stream`	유형`boolean`	요건선택 사항	값과 한도 false	기본값false
필드`n`	유형`integer`	요건선택 사항	값과 한도 1	기본값—
필드`size`	유형`string`	요건선택 사항	값과 한도 1024x1024	기본값—

메서드 매개변수와 수명 주기

매개변수	명세
매개변수`content_type`	명세application/json
매개변수`required`	명세model, prompt
매개변수`optional`	명세stream, n, size
매개변수`material_types`	명세text
매개변수`conditions`	명세Use stream:false or omit stream. The complete buffered JSON result contains all generated images.

수명 주기: synchronous_result_then_owned_library

GET /v1/media/assets

GET /v1/media/assets/{asset_id}

요금

최종 요금 계산 방식

표시된 요율은 생성 전 비용을 예상하는 데 사용됩니다. 최종 청구액은 최초 생성에 기록된 비용으로 계산됩니다. 측정된 출력 길이와 예상 수량은 최종 청구 수량이 아닙니다.

요금 정보는 요청 옵션을 추가하지 않습니다. 지원되는 매개변수는 선택한 메서드에 표시됩니다.

빠른 모드: 미지정 빠른 모드를 선택한 경우
Flex 모드: 미지정 flex 모드를 선택한 경우
최대 추론 수준: 미지정 최대 추론 수준에 default 조정값을 적용하는 경우

비교용 예상 요금

설정별 가격

각 요금을 표시된 조건과 대조하세요. 서로 대체되는 설정 묶음마다 하나의 요금만 적용하세요.

설정	요금표	예측 수량	요금
설정기본 토큰 요금	요금표기본 요금	예측 수량—	요금 입력 · 입력 토큰 · 비교 전용 추정치 — / 1K 토큰 출력 · 출력 토큰 · 비교 전용 추정치 — / 1K 토큰 입력 · 캐시 읽기 · 비교 전용 추정치 — / 1K 토큰 입력 · 캐시 쓰기 · 비교 전용 추정치 — / 1K 토큰 입력 · 캐시 쓰기, 1시간 · 비교 전용 추정치 — / 1K 토큰
설정Estimated generation cost	요금표—	예측 수량1회 생성 예상치	요금 입력 · 예상 생성 비용 · 비교 전용 추정치 $0.32768 생성 전 추정치 This estimate is not an additional charge or a fixed rate for the completed generation.

Ailoot는 요청 전에 예상 금액을 미리 확보합니다. 결과를 받은 뒤 측정된 사용량을 기준으로 최종 요금을 정산합니다. 스트리밍 정산에는 최종 사용량 기록을 사용합니다. 금액 확보와 정산 방식 →

요청 예제

Ailoot Ultra · Images

curl · 한 번만 생성하고 결과 전체 보관

set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
export AILOOT_API_KEY
python3 - <<'PY_REQUEST'
import json,os
from pathlib import Path
p=json.loads('{"model": "openai/dall-e-3", "prompt": "A calm studio product photograph with a plain background.", "n": 1, "size": "1024x1024"}')

Path("request.json").write_text(json.dumps(p,ensure_ascii=False))
PY_REQUEST
curl --fail-with-body --silent --show-error https://api.ailoot.ai/v1/images/generations \
  -H "Authorization: Bearer $AILOOT_API_KEY" -H 'Content-Type: application/json' \
  --data-binary @request.json -D response-headers.txt -o result.json
# Submit once. Retain the complete result, original identifiers and every response header.

결과 수신 및 저장

Ailoot Ultra · Images

반환된 각 이미지를 다운로드하거나 Base64 내용을 저장하세요

GET /v1/media/assets
GET /v1/media/assets/{asset_id}

완료된 결과 모두 보관

완료된 이미지를 모두 저장하세요. 반환된 각 URL에서 가져오거나 Base64 내용을 디코딩하세요.

Retain every returned image and field. Use owned content_url values and actual asset_id records; refresh the same asset when a link expires.

원래 응답을 확인해야 할 경우

Preserve the original response, headers and X-Client-Request-ID. An uncertain outcome does not authorize another creation.

별칭

모델 별칭

Ailoot Ultra openai/dall-e-3, dall-e-3

메서드 경로 별칭

위에 표시된 메서드 경로를 사용하세요.

시작하기

허용 입력: 텍스트
결과: 이미지

Ailoot에서 사용 가능 · 입력 및 메서드

Ailoot Ultra · Images POST /v1/images/generations

입력: text
출력: image
출력 형식: 이미지 파일

필드	유형	요건	값과 한도	기본값
필드`model`	유형`string`	요건필수	값과 한도 dall-e-3	기본값—
필드`prompt`	유형`string`	요건필수	값과 한도	기본값—
필드`stream`	유형`boolean`	요건선택 사항	값과 한도 false	기본값false
필드`n`	유형`integer`	요건선택 사항	값과 한도 1	기본값—
필드`size`	유형`string`	요건선택 사항	값과 한도 1024x1024	기본값—

메서드 매개변수와 수명 주기

매개변수	명세
매개변수`content_type`	명세application/json
매개변수`required`	명세model, prompt
매개변수`optional`	명세stream, n, size
매개변수`material_types`	명세text
매개변수`conditions`	명세Use stream:false or omit stream. The complete buffered JSON result contains all generated images.

수명 주기: synchronous_result_then_owned_library

GET /v1/media/assets

GET /v1/media/assets/{asset_id}

요금

최종 요금 계산 방식

요금 정보는 요청 옵션을 추가하지 않습니다. 지원되는 매개변수는 선택한 메서드에 표시됩니다.

빠른 모드: 미지정 빠른 모드를 선택한 경우
Flex 모드: 미지정 flex 모드를 선택한 경우
최대 추론 수준: 미지정 최대 추론 수준에 default 조정값을 적용하는 경우

비교용 예상 요금

설정별 가격

각 요금을 표시된 조건과 대조하세요. 서로 대체되는 설정 묶음마다 하나의 요금만 적용하세요.

설정	요금표	예측 수량	요금
설정기본 토큰 요금	요금표기본 요금	예측 수량—	요금 입력 · 입력 토큰 · 비교 전용 추정치 — / 1K 토큰 출력 · 출력 토큰 · 비교 전용 추정치 — / 1K 토큰 입력 · 캐시 읽기 · 비교 전용 추정치 — / 1K 토큰 입력 · 캐시 쓰기 · 비교 전용 추정치 — / 1K 토큰 입력 · 캐시 쓰기, 1시간 · 비교 전용 추정치 — / 1K 토큰
설정Estimated generation cost	요금표—	예측 수량1회 생성 예상치	요금 입력 · 예상 생성 비용 · 비교 전용 추정치 $0.32768 생성 전 추정치 This estimate is not an additional charge or a fixed rate for the completed generation.

요청 예제

Ailoot Ultra · Images

curl · 한 번만 생성하고 결과 전체 보관

set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
export AILOOT_API_KEY
python3 - <<'PY_REQUEST'
import json,os
from pathlib import Path
p=json.loads('{"model": "dall-e-3", "prompt": "A calm studio product photograph with a plain background.", "n": 1, "size": "1024x1024"}')

Path("request.json").write_text(json.dumps(p,ensure_ascii=False))
PY_REQUEST
curl --fail-with-body --silent --show-error https://api.ailoot.ai/v1/images/generations \
  -H "Authorization: Bearer $AILOOT_API_KEY" -H 'Content-Type: application/json' \
  --data-binary @request.json -D response-headers.txt -o result.json
# Submit once. Retain the complete result, original identifiers and every response header.

결과 수신 및 저장

Ailoot Ultra · Images

반환된 각 이미지를 다운로드하거나 Base64 내용을 저장하세요

GET /v1/media/assets
GET /v1/media/assets/{asset_id}

완료된 결과 모두 보관

완료된 이미지를 모두 저장하세요. 반환된 각 URL에서 가져오거나 Base64 내용을 디코딩하세요.

Retain every returned image and field. Use owned content_url values and actual asset_id records; refresh the same asset when a link expires.

원래 응답을 확인해야 할 경우

Preserve the original response, headers and X-Client-Request-ID. An uncertain outcome does not authorize another creation.

별칭

모델 별칭

Ailoot Ultra openai/dall-e-3, dall-e-3

메서드 경로 별칭

위에 표시된 메서드 경로를 사용하세요.

OpenAI: DALL·E 3

OpenAI: DALL·E 3

시작하기

Ailoot에서 사용 가능 · 입력 및 메서드

요금

최종 요금 계산 방식

비교용 예상 요금

설정별 가격

요청 예제

Ailoot Ultra · Images

결과 수신 및 저장

Ailoot Ultra · Images

완료된 결과 모두 보관

원래 응답을 확인해야 할 경우

별칭

모델 별칭

메서드 경로 별칭

관련 호출용 ID

시작하기

Ailoot에서 사용 가능 · 입력 및 메서드

요금

최종 요금 계산 방식

비교용 예상 요금

설정별 가격

요청 예제

Ailoot Ultra · Images

결과 수신 및 저장

Ailoot Ultra · Images

완료된 결과 모두 보관

원래 응답을 확인해야 할 경우

별칭

모델 별칭

메서드 경로 별칭

관련 호출용 ID

회사와 그 프로젝트 포트폴리오

할인받아 토큰을 구매하세요.

판매하는 제품에 API를 연결하세요.