Zhipu: CogView 4 250304
CogView 4 250304 est le sélecteur CogView 4 nommé séparément cogview-4-250304 pour la génération d’images à partir de texte. Utilisez-le lorsqu’un flux de travail exige cette identité exacte de modèle, avec un brief de scène écrit et les paramètres de dimensions, de qualité et de filigrane propres à CogView. Il renvoie des URL d’images dans une réponse synchrone de génération d’images.
À propos du modèle
Cette description présente les capacités du modèle. Les entrées, sorties et options disponibles dans Ailoot pour la méthode sélectionnée figurent ci-dessous.
CogView 4 250304 est le modèle nommé cogview-4-250304 de Zhipu dans la famille de génération d’images CogView. Utilisez le sélecteur complet lorsque vous souhaitez conserver cette édition dans un flux de travail créatif. Sa méthode Ailoot Ultra est POST /v1/images/generations, avec model et prompt comme champs de chaîne obligatoires. L’entrée de ce profil est une description écrite de l’image.
Préparez le brief autour d’un livrable visible. Une illustration éditoriale peut décrire une personne qui attend dans une gare, la météo, la relation entre le sujet et l’arrière-plan et le traitement chromatique souhaité. Pour une scène de produit, indiquez la disposition du produit, le point de vue, la surface et l’éclairage. Expliquez quels détails comptent le plus, puis comparez-les au fichier généré. Conserver ensemble le brief et le sélecteur exact facilite l’évaluation des révisions ultérieures.
Les indications de dimensions propres à CogView comprennent le format carré 1024x1024, les formats portrait 768x1344 ou 864x1152, les formats paysage 1344x768 ou 1152x864, ainsi que les formats larges ou hauts 1440x720 ou 720x1440. Pour les dimensions personnalisées, chaque côté est compris entre 512 et 2048 pixels, chacun est divisible par 16 et le nombre total de pixels ne peut dépasser 2^21. Prévoyez le placement du sujet pour le cadre choisi au lieu de traiter un changement de dimensions comme un simple recadrage.
Les valeurs documentées de quality sont standard et hd ; la valeur par défaut de CogView est standard. watermark_enabled contrôle le filigrane et vaut true par défaut. Le paramètre facultatif user_id est une chaîne de 6 à 128 caractères pour l’identifiant de l’utilisateur final. Conservez les paramètres de qualité et de filigrane choisis avec le résultat, notamment lorsque vous réunissez plusieurs propositions pour une même tâche de design.
La requête d’image se termine de manière synchrone avec created et un tableau data dont les éléments contiennent url. Enregistrez chaque image réellement renvoyée et conservez la réponse complète. Un groupe d’URL renvoyées constitue l’ensemble de sortie ; choisir une image préférée pour une mise en page ne doit pas supprimer les autres de l’enregistrement de génération. Conservez les informations de la requête et de la réponse d’origine lorsqu’une connexion se termine avant que le résultat complet soit connu, et vérifiez le résultat existant avant de lancer une autre requête de création. Ailoot stocke ces images comme ressources multimédias dont vous êtes propriétaire et renvoie des liens Ailoot signés. Retrouvez les enregistrements des ressources via GET /v1/media/assets?family=image, en suivant chaque next_cursor. Appelez GET /v1/media/assets/{asset_id} avec chaque asset_id réel pour obtenir son content_url ; relisez cette même ressource si son lien signé expire.
Ailoot Ultra · Images POST /v1/images/generations cogview-4-250304
cogview-4-250304Premiers pas
CogView 4 250304 est le sélecteur CogView 4 nommé séparément cogview-4-250304 pour la génération d’images à partir de texte. Utilisez-le lorsqu’un flux de travail exige cette identité exacte de modèle, avec un brief de scène écrit et les paramètres de dimensions, de qualité et de filigrane propres à CogView. Il renvoie des URL d’images dans une réponse synchrone de génération d’images.
- Entrées acceptées
- Texte
- Résultats
- Images
Disponible dans Ailoot · entrées et méthodes
Ailoot Ultra · Images POST /v1/images/generations
- Types d’entrée
text- Types de sortie
image- Format de sortie
- Fichier image
| Champ | Type | Exigence | Valeurs et limites | Par défaut |
|---|---|---|---|---|
Champmodel | Typestring | ExigenceObligatoire | Valeurs et limites cogview-4-250304 | Par défaut— |
Champprompt | Typestring | ExigenceObligatoire | Valeurs et limites | Par défaut— |
Champsize | Typestring | ExigenceFacultatif | Valeurs et limites 1280x1280, 1568x1056, 1056x1568, 1472x1088, 1088x1472, 1728x960, 960x1728 | Par défaut1280x1280 |
Champuser_id | Typestring | ExigenceFacultatif | Valeurs et limites | Par défaut— |
Champquality | Typestring | ExigenceFacultatif | Valeurs et limites hd, standard | Par défaut— |
Champwatermark_enabled | Typeboolean | ExigenceFacultatif | Valeurs et limites | Par défauttrue |
Champstream | Typeboolean | ExigenceFacultatif | Valeurs et limites false | Par défaut— |
Paramètres et cycle de vie de la méthode
| Paramètre | Contrat |
|---|---|
Paramètrecontent_type | Contratapplication/json |
Paramètrerequired | Contratmodel, prompt |
Paramètreoptional | Contratsize, user_id, quality, watermark_enabled, stream |
Paramètrematerial_types | Contrattext |
Paramètreconditions | ContratUse stream:false or omit stream. The complete buffered JSON result contains all generated images. |
Cycle de vie : synchronous_result_then_owned_library
GET /v1/media/assets
GET /v1/media/assets/{asset_id}
Tarifs
Calcul du coût final
Les tarifs affichés servent à estimer le coût avant la génération. Le montant final est calculé à partir du coût enregistré pour la génération d’origine. La durée mesurée du résultat et les quantités prévisionnelles ne constituent pas la quantité finale facturable.
Les tarifs n’ajoutent pas d’options de requête. Les paramètres pris en charge figurent dans la méthode sélectionnée.
- Mode rapide
- Non précisé Lorsque le mode rapide est sélectionné
- Mode Flex
- Non précisé Lorsque le mode flex est sélectionné
- Effort de raisonnement maximal
- Non précisé Lorsque l’effort de raisonnement maximal utilise l’ajustement par défaut (default)
Tarifs estimés à des fins de comparaison
Prix par configuration
Associez chaque coût aux conditions indiquées. Utilisez un seul tarif pour chaque ensemble de configurations alternatives.
| Configuration | Barème tarifaire | Quantité prévisionnelle | Coût |
|---|---|---|---|
| ConfigurationTarifs de base par jeton | Barème tarifaireTarif de base | Quantité prévisionnelle— | Coût Entrée · Tokens en entrée · Estimation à des fins de comparaison uniquement — / 1K tokens Sortie · Tokens en sortie · Estimation à des fins de comparaison uniquement — / 1K tokens Entrée · Lecture du cache · Estimation à des fins de comparaison uniquement — / 1K tokens Entrée · Écriture dans le cache · Estimation à des fins de comparaison uniquement — / 1K tokens Entrée · Écriture dans le cache, 1 h · Estimation à des fins de comparaison uniquement — / 1K tokens |
| ConfigurationEstimated generation cost | Barème tarifaire— | Quantité prévisionnelleEstimation pour une génération | Coût Entrée · Coût estimé de génération · Estimation à des fins de comparaison uniquement $0.09 estimation avant génération This estimate is not an additional charge or a fixed rate for the completed generation. |
Ailoot réserve un montant estimé avant une requête. Après le résultat, le montant final est débité selon l’utilisation mesurée. Pour le streaming, le montant final à débiter est calculé à partir du relevé final d’utilisation. Fonctionnement de la réservation et du débit →
Exemples de requêtes
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.
Recevoir et enregistrer les résultats
Ailoot Ultra · Images
Téléchargez chaque image renvoyée ou enregistrez son contenu Base64
GET /v1/media/assetsGET /v1/media/assets/{asset_id}
Conserver tous les résultats terminés
Enregistrez chaque image terminée ; récupérez chaque URL renvoyée ou décodez son contenu 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.
Si la réponse d’origine doit être vérifiée
Preserve the original response, headers and X-Client-Request-ID. An uncertain outcome does not authorize another creation.
Alias
Alias du modèle
Ailoot Ultra cogview-4-250304
Alias des chemins de méthode
Utilisez les chemins de méthode indiqués ci-dessus.
ID d’appel associés
FAQ · Zhipu: CogView 4 250304
- Quelles entrées et quels résultats sont disponibles ?
POST /v1/images/generations·cogview-4-250304:text→image- Quels champs la requête utilise-t-elle ?
POST /v1/images/generations·cogview-4-250304:model,prompt,size,user_id,quality,watermark_enabled,stream