Recraft: Recraft V4 Vector

Recraft V4 Vector는 창작 지시로 편집 가능한 SVG 로고, 일러스트, 그래픽 자산을 만듭니다. 확장 가능한 기하 구조, 선택적인 스타일 참조, 별도로 문서화된 이미지-이미지 워크플로를 제공하는 V4의 표준 벡터 에디션입니다.

Ailoot Ultra · Images POST /v1/images/generations recraft/recraft-v4-vector

모델 소개

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

Recraft V4 Vector는 Recraft V4의 표준 SVG 생성 에디션입니다. 로고, 아이콘 체계, 일러스트처럼 명확한 형태, 색 영역, 구도에 의존하는 그래픽을 위해 설계되었습니다. 제조사는 V4를 래스터와 벡터 작업 모두에서 프롬프트 해석이 뛰어난 디자인 중심 제품군으로 설명합니다. 이 에디션의 산출물은 PNG나 WebP 비트맵이 아니라 디자인 워크플로에서 조정할 수 있는 편집 가능한 SVG 아트워크입니다.

정확한 모델은 recraftv4_vector이며, V4 Pro Vector 및 래스터 V4 변형과 구분됩니다. 제작사 크기 가이드는 벡터 출력에 14개의 너비와 높이 비율을 허용하며 SVG에는 고정 픽셀 크기가 없다고 명시합니다. 화면비로 자산 형태를 선택한 다음 최종 디자인에서 배치와 표시 크기를 정하세요. 래스터 V4 모델의 1K 라벨이 이 SVG 변형의 해상도를 정의하지는 않습니다.

V4 벡터 지침은 그래픽 유형, 형태 논리, 색 체계, 선의 규칙, 배치를 정의하도록 권장합니다. 작은 아이콘에서는 물체와 그것을 알아볼 수 있게 하는 실루엣을 명시하세요. 일러스트 체계에서는 지시문마다 선과 채움 규칙을 안정적으로 유지하세요. 배송 아이콘에서는 둥근 모서리의 윤곽선 밴, 큰 소포 형태 하나, 절제된 팔레트를 정사각 구도의 중앙에 배치하도록 요청할 수 있습니다. 평면 그래픽이 목표라면 사진 같은 표면 세부 정보를 추가하기보다 기하 구조를 설명하세요.

생성은 최대 10,000자 프롬프트, 무작위 시드, 이미지 1~6장, 선호 색 및 배경색 설정을 지원합니다. 선택 사항인 호환 스타일 또는 참조 이미지로 flexible 또는 precise 매칭을 통해 시각 언어를 유도할 수 있습니다. 참조가 새로운 피사체나 배치에 관한 지시를 대신하지는 않습니다. 선명한 자산 하나 또는 일관된 참조 세트를 사용하세요. 참조와 정확히 같은 색은 보장되지 않습니다. 참조 스타일 생성에는 PNG, JPG 또는 WebP 이미지 1~10장을 사용하세요. 총 크기는 64 MB 이하여야 하며 각 파일은 20 MB 미만이어야 합니다. 각 참조는 짧은 변이 최소 256픽셀, 긴 변이 최대 4,096픽셀이고 해상도는 최대 16메가픽셀이어야 합니다. 이 참조 또는 호환되는 저장된 스타일 중 하나만 사용하고 둘을 함께 사용하지 마세요.

별도의 이미지-이미지 워크플로에서는 V4 벡터 모델로 기존 이미지와 텍스트 변경 요청에서 SVG를 만들 수 있습니다. 필수 strength 설정은 0~1입니다. 낮은 값은 원본에 더 가깝게 유지하고 높은 값은 더 큰 변경을 허용합니다. 이 작업은 문서에 명시된 크기 및 해상도 제한 안의 PNG, JPG, WebP 또는 SVG를 받으며 V4 스타일 설정은 받지 않습니다. 이미지가 변형할 콘텐츠를 제공해야 하는지 새 자산의 시각 표현만 제공해야 하는지 선택할 때 이 구분이 중요합니다. 이미지-이미지에는 20 MB 미만, 최대 16메가픽셀, 두 변 모두 256~4,096픽셀인 PNG, JPG, WebP 또는 SVG를 제공하세요.

현재 V4 생성 참조는 선별된 스타일 이름, negative_prompt, text_layout, artistic_level, no_text를 제외합니다. 의도한 구조와 문구를 긍정형 지시문에 넣으세요. 로고나 레터링 결과에서는 SVG를 작은 크기와 큰 크기로 살펴 간격, 가독성, 원치 않는 세부 정보를 확인하세요. 타이포그래피 위계와 기하 형태를 명시한 다음 디자인 지시에 맞춰 벡터 자산을 마무리하고 배치하세요.

Ailoot에서는 /v1/images/generations에서 이 정확한 모델 ID를 선택하고 창작 프롬프트를 제공하세요. 응답에 URL이 있든 인코딩된 이미지 콘텐츠가 있든 반환된 모든 data 항목을 보존하고, 반환된 콘텐츠 유형과 함께 실제 바이트를 저장하세요. 자산과 함께 usage 및 미디어 task_id가 있으면 이를 보관한 다음, 사용할 디자인에서 형태, 글자, 색 영역을 검토하세요.

Ailoot Ultra · Images POST /v1/images/generations recraft/recraft-v4-vector

recraft/recraft-v4-vector

기타 /recraft/recraft-v4-vector

시작하기

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

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

Ailoot Ultra · Images POST /v1/images/generations

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

필드	유형	요건	값과 한도	기본값
필드`model`	유형`string`	요건필수	값과 한도 recraft/recraft-v4-vector 조건: 이 Ailoot 라우팅 선택자를 그대로 사용하세요.	기본값—
필드`prompt`	유형`string`	요건필수	값과 한도 조건:	기본값—
필드`n`	유형`integer`	요건선택 사항	값과 한도 최솟값: 1 최댓값: 6 조건:	기본값—
필드`aspect_ratio`	유형`string`	요건선택 사항	값과 한도 1:1, 4:3, 3:4, 16:9, 9:16, auto 조건:	기본값—
필드`output_format`	유형`string`	요건선택 사항	값과 한도 svg 조건:	기본값—
필드`input_references`	유형`array`	요건선택 사항	값과 한도 조건:	기본값—
필드`quality`	유형`string`	요건선택 사항	값과 한도 auto, low, medium, high, xhigh, max 조건:	기본값—

입력 자료 조합

텍스트로 이미지 생성

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

매개변수	명세
매개변수`content_type`	명세application/json
매개변수`required`	명세model, prompt
매개변수`optional`	명세n, aspect_ratio, output_format, input_references, quality
매개변수`material_types`	명세text, image
매개변수`conditions`	명세이 Ailoot 라우팅 선택자를 그대로 사용하세요., quality는 일반적으로 문서화된 제어 항목입니다. 품질 설정이 없는 공급자는 이 값을 무시합니다. 모델별 품질 향상을 보장하지 않습니다.

수명 주기: synchronous_result_then_owned_library

GET /v1/media/tasks/{task_id} · 실제로 반환된 task_id 또는 선택한 라이브러리 기록입니다. operation_id는 별도의 식별자입니다.

GET /v1/media/assets

GET /v1/media/assets/{asset_id}

요금

최종 요금 계산 방식

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

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

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

비교용 예상 요금

설정별 가격

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

설정	요금표	예측 수량	과금 단위	요금
설정기본 토큰 요금	요금표기본 요금	예측 수량—	과금 단위—	요금 입력 · 입력 토큰 · 비교 전용 추정치 — / 1K 토큰 출력 · 출력 토큰 · 비교 전용 추정치 — / 1K 토큰 입력 · 캐시 읽기 · 비교 전용 추정치 — / 1K 토큰 입력 · 캐시 쓰기 · 비교 전용 추정치 — / 1K 토큰 입력 · 캐시 쓰기, 1시간 · 비교 전용 추정치 — / 1K 토큰
설정출력 이미지	요금표—	예측 수량—	과금 단위출력 이미지당	요금 출력 · 출력 이미지 · 비교 전용 추정치 $0.16 출력 이미지당
설정예상 생성 비용	요금표—	예측 수량1회 생성 예상치	과금 단위—	요금 출력 · 예상 생성 비용 · 비교 전용 추정치 $0.16 생성 전 추정치 이 예상 금액은 추가 요금이나 생성 완료 시 적용되는 고정 요금이 아닙니다.

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": "recraft/recraft-v4-vector", "prompt": "A portrait of an Asian woman with neon green lights in the background, shallow depth of field."}')

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/tasks/{task_id}
GET /v1/media/assets
GET /v1/media/assets/{asset_id}

완료된 결과 모두 보관

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

응답과 헤더 전체, 원래 식별자, 모든 실제 출력 및 모든 사용량/회계 필드를 보존하세요. 고유한 소유 자산을 각각 저장하고 해당 자산을 가리키는 모든 역할을 유지하세요.

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

원래 X-Client-Request-ID, 응답 및 헤더를 보존하세요. 결과를 알 수 없거나 result_pending_check인 경우 두 번째 생성은 허용되지 않습니다.

응답 필드

필드	유형
필드`data[].url`	유형string
필드`data[].b64_json`	유형string
필드`usage`	유형object

오류와 다음 단계

응답	조건	다음 단계
응답400 · `invalid_request_error`	조건필수 필드, 모델 선택자, 유형 또는 입력 표현 형식이 유효하지 않습니다.	다음 단계별도의 요청을 준비하기 전에 반환된 유효성 검사 세부 정보를 확인하세요.
응답	조건원래 요청이나 결과를 알 수 없거나 확인이 필요합니다.	다음 단계원래 식별자와 헤더를 보존하고, 지원되는 상태 정보나 라이브러리 기록만 조회하세요. 생성 요청을 다시 제출하지 마세요.

별칭

모델 별칭

Ailoot Ultra recraft/recraft-v4-vector

메서드 경로 별칭

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

Recraft: Recraft V4 Vector