Zhipu: CogView 4
CogView 4는 Zhipu의 텍스트 이미지 생성 모델이며, Ailoot Ultra에서 정확한 ID cogview-4로 사용할 수 있습니다. 장면 설명을 제공해 일러스트, 제품 배경 장면, 시각적 콘셉트를 만드세요. 문서에 나온 제어 항목에는 이미지 크기, standard 또는 hd 품질, watermark_enabled가 있으며, 응답으로 제공되는 이미지 URL은 모두 저장해야 합니다.
모델 소개
이 설명은 모델의 기능을 다룹니다. Ailoot에서 사용할 수 있는 입력, 출력 및 옵션은 아래에 선택한 메서드별로 표시됩니다.
CogView 4는 텍스트로 작성한 이미지 생성 지시를 이미지 결과물로 만듭니다. POST /v1/images/generations에서 cogview-4를 선택하고 prompt를 텍스트 문자열로 제공하세요. 필수 입력은 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와 data를 포함하는 동기식 JSON 응답으로 반환됩니다. 각 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
cogview-4시작하기
CogView 4는 Zhipu의 텍스트 이미지 생성 모델이며, Ailoot Ultra에서 정확한 ID cogview-4로 사용할 수 있습니다. 장면 설명을 제공해 일러스트, 제품 배경 장면, 시각적 콘셉트를 만드세요. 문서에 나온 제어 항목에는 이미지 크기, standard 또는 hd 품질, watermark_enabled가 있으며, 응답으로 제공되는 이미지 URL은 모두 저장해야 합니다.
- 허용 입력
- 텍스트
- 결과
- 이미지
Ailoot에서 사용 가능 · 입력 및 메서드
Ailoot Ultra · Images POST /v1/images/generations
- 입력
text- 출력
image- 출력 형식
- 이미지 파일
| 필드 | 유형 | 요건 | 값과 한도 | 기본값 |
|---|---|---|---|---|
필드model | 유형string | 요건필수 | 값과 한도 cogview-4 | 기본값— |
필드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", "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
메서드 경로 별칭
위에 표시된 메서드 경로를 사용하세요.
관련 호출용 ID
FAQ · Zhipu: CogView 4
- 어떤 입력과 결과를 사용할 수 있나요?
POST /v1/images/generations·cogview-4:text→image- 요청은 어떤 필드를 사용하나요?
POST /v1/images/generations·cogview-4:model,prompt,size,user_id,quality,watermark_enabled,stream