Zhipu: CogView 4 250304
CogView 4 250304는 텍스트 이미지 생성 작업용으로 별도 이름이 지정된 CogView 4 선택자 cogview-4-250304입니다. 작업 흐름에서 이 정확한 모델 식별이 필요할 때 텍스트로 작성한 장면 지시, CogView 전용 크기, 품질, 워터마크 설정과 함께 사용하세요. 동기식 이미지 생성 응답을 통해 이미지 URL을 반환합니다.
모델 소개
이 설명은 모델의 기능을 다룹니다. Ailoot에서 사용할 수 있는 입력, 출력 및 옵션은 아래에 선택한 메서드별로 표시됩니다.
CogView 4 250304는 CogView 이미지 생성 제품군에서 Zhipu가 cogview-4-250304라는 이름으로 제공하는 모델입니다. 창작 작업 흐름에서 이 버전을 유지하려면 완전한 선택자를 사용하세요. Ailoot Ultra 메서드는 POST /v1/images/generations이며, model과 prompt가 필수 문자열 필드입니다. 이 프로필의 입력은 텍스트로 작성한 이미지 설명입니다.
눈으로 확인할 수 있는 결과물을 중심으로 작업 지시를 준비하세요. 편집용 일러스트라면 역에서 기다리는 사람, 날씨, 피사체와 배경의 관계, 원하는 색채 표현을 설명할 수 있습니다. 제품 장면이라면 제품 배치, 시점, 표면, 조명을 명시하세요. 가장 중요한 세부 요소를 설명하고 생성된 파일에서 그 요소를 대조하세요. 작업 지시와 정확한 선택자를 함께 보관하면 나중에 수정 결과를 평가하기 쉽습니다.
CogView 전용 크기 지침에는 정사각형 1024x1024, 세로형 768x1344 또는 864x1152, 가로형 1344x768 또는 1152x864, 넓거나 긴 형태의 1440x720 또는 720x1440이 포함됩니다. 사용자 지정 크기에서는 각 변이 512에서 2048픽셀 사이이고 16으로 나누어떨어져야 하며, 총 픽셀 수는 2^21을 초과할 수 없습니다. 크기 변경을 단순한 자르기로 취급하지 말고 선택한 프레임에 맞춰 피사체 배치를 계획하세요.
문서에 나온 quality 값은 standard와 hd이며, CogView 기본값은 standard입니다. watermark_enabled는 워터마크를 제어하며 기본값은 true입니다. 선택 항목인 user_id는 최종 사용자 식별자를 위한 6~128자 문자열입니다. 특히 같은 디자인 작업의 후보를 여러 개 모을 때는 선택한 품질 및 워터마크 설정을 결과와 함께 보관하세요.
이미지 요청은 created와 각 항목에 url이 들어 있는 data 배열을 반환하며 동기식으로 완료됩니다. 실제 반환된 이미지를 각각 저장하고 완전한 응답을 보관하세요. 반환된 URL 묶음이 결과 세트입니다. 레이아웃에 쓸 선호 이미지 하나를 골랐다고 해서 다른 이미지를 생성 기록에서 버려서는 안 됩니다. 완전한 결과를 알기 전에 연결이 끊기면 원래 요청과 응답 정보를 보관하고, 추가 생성 요청 전에 기존 결과를 확인하세요. Ailoot는 이 이미지를 소유 미디어 자산으로 저장하고 서명된 Ailoot 링크를 반환합니다. GET /v1/media/assets?family=image로 자산 기록을 찾고 모든 next_cursor를 따라가세요. 실제 asset_id마다 GET /v1/media/assets/{asset_id}를 읽어 content_url을 얻으세요. 서명된 링크가 만료되면 같은 자산을 다시 읽으세요.
Ailoot Ultra · Images POST /v1/images/generations cogview-4-250304
cogview-4-250304시작하기
CogView 4 250304는 텍스트 이미지 생성 작업용으로 별도 이름이 지정된 CogView 4 선택자 cogview-4-250304입니다. 작업 흐름에서 이 정확한 모델 식별이 필요할 때 텍스트로 작성한 장면 지시, CogView 전용 크기, 품질, 워터마크 설정과 함께 사용하세요. 동기식 이미지 생성 응답을 통해 이미지 URL을 반환합니다.
- 허용 입력
- 텍스트
- 결과
- 이미지
Ailoot에서 사용 가능 · 입력 및 메서드
Ailoot Ultra · Images POST /v1/images/generations
- 입력
text- 출력
image- 출력 형식
- 이미지 파일
| 필드 | 유형 | 요건 | 값과 한도 | 기본값 |
|---|---|---|---|---|
필드model | 유형string | 요건필수 | 값과 한도 cogview-4-250304 | 기본값— |
필드prompt | 유형string | 요건필수 | 값과 한도 | 기본값— |
필드size | 유형string | 요건선택 사항 | 값과 한도 1280x1280, 1568x1056, 1056x1568, 1472x1088, 1088x1472, 1728x960, 960x1728 | 기본값1280x1280 |
필드user_id | 유형string | 요건선택 사항 | 값과 한도 | 기본값— |
필드quality | 유형string | 요건선택 사항 | 값과 한도 hd, standard | 기본값— |
필드watermark_enabled | 유형boolean | 요건선택 사항 | 값과 한도 | 기본값true |
필드stream | 유형boolean | 요건선택 사항 | 값과 한도 false | 기본값— |
메서드 매개변수와 수명 주기
| 매개변수 | 명세 |
|---|---|
매개변수content_type | 명세application/json |
매개변수required | 명세model, prompt |
매개변수optional | 명세size, user_id, quality, watermark_enabled, stream |
매개변수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.09 생성 전 추정치 This estimate is not an additional charge or a fixed rate for the completed generation. |
Ailoot는 요청 전에 예상 금액을 미리 확보합니다. 결과를 받은 뒤 측정된 사용량을 기준으로 최종 요금을 정산합니다. 스트리밍 정산에는 최종 사용량 기록을 사용합니다. 금액 확보와 정산 방식 →
요청 예제
Ailoot Ultra · Images
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": "cogview-4-250304", "prompt": "A calm studio product photograph with a plain background."}')
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/assetsGET /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 cogview-4-250304
메서드 경로 별칭
위에 표시된 메서드 경로를 사용하세요.
관련 호출용 ID
FAQ · Zhipu: CogView 4 250304
- 어떤 입력과 결과를 사용할 수 있나요?
POST /v1/images/generations·cogview-4-250304:text→image- 요청은 어떤 필드를 사용하나요?
POST /v1/images/generations·cogview-4-250304:model,prompt,size,user_id,quality,watermark_enabled,stream