tripo-cli 0.7.1 → 0.7.3

package/dist/knowledge/models.js

@@ -52,6 +52,7 @@ export const P2_FORBIDDEN_PARAMS = ['smart_low_poly', 'generate_parts', 'geometr
 /** Rig wire versions (backend whitelist; marketing names rig-v1.0/rig-v2.0 are rejected). */
 export const RIG_MODEL_V1 = 'v1.0-20240301';
 export const RIG_MODEL_V25 = 'v2.5-20260210';
+export const RIG_MODEL_V30 = 'v3.0-20260909';
 /** Marketing rig names → wire versions the server actually accepts. */
 export const RIG_MODEL_ALIASES = {
     'rig-v1.0': RIG_MODEL_V1,
@@ -59,6 +60,8 @@ export const RIG_MODEL_ALIASES = {
     'rig-v2.0': RIG_MODEL_V25,
     'rig-v2.5': RIG_MODEL_V25,
     'v2.5-20260210': RIG_MODEL_V25,
+    'rig-v3.0': RIG_MODEL_V30,
+    'v3.0-20260909': RIG_MODEL_V30,
 };
 export function normalizeRigModel(input) {
     return RIG_MODEL_ALIASES[input] ?? input;
@@ -67,8 +70,9 @@ export function normalizeRigModel(input) {
 export const CAPABILITY_DEFAULTS = {
     texture: 'v3.0-20250812',
     /** Server default is v1.0 (biped-only presets); the CLI defaults to the
-     *  v2.5 rig which has presets for all seven body types. */
-    rig: RIG_MODEL_V25,
+     *  v3.0 rig: recommended for humanoids, v2.5 behavior and presets for the
+     *  other body types. */
+    rig: RIG_MODEL_V30,
     segment: 'v1.0-20250506',
     textToImage: 'seedream_v4',
     imageToImage: 'seedream_v5',
@@ -81,8 +85,18 @@ export const RIG_TYPES = [
     'avian',
     'serpentine',
     'aquatic',
+    'others',
 ];
-export const RIG_SPECS = ['tripo', 'mixamo'];
+/** Bone naming specs (biped only); actorcore/unity/unreal/vrm need rig v3.0. */
+export const RIG_SPECS = ['tripo', 'mixamo', 'actorcore', 'unity', 'unreal', 'vrm'];
+/** Retarget presets of non-biped rig types (rig v2.5/v3.0); avian and others have none. */
+export const NON_BIPED_PRESETS = {
+    quadruped: ['preset:quadruped:walk'],
+    hexapod: ['preset:hexapod:walk'],
+    octopod: ['preset:octopod:walk'],
+    serpentine: ['preset:serpentine:march'],
+    aquatic: ['preset:aquatic:march'],
+};
 /** Per-endpoint image model whitelists (ImageGenerationValidation):
  *  image-to-image does NOT accept seedream_v4. */
 export const TEXT_TO_IMAGE_MODELS = [
@@ -94,6 +108,8 @@ export const TEXT_TO_IMAGE_MODELS = [
     'chat_image_1',
     'chat_image_1.5',
     'chat_image_2',
+    'chat_image_2.5_flare',
+    'chat_image_2.5_sunburst',
 ];
 export const IMAGE_TO_IMAGE_MODELS = [
     'seedream_v5',
@@ -103,9 +119,13 @@ export const IMAGE_TO_IMAGE_MODELS = [
     'chat_image_1',
     'chat_image_1.5',
     'chat_image_2',
+    'chat_image_2.5_flare',
+    'chat_image_2.5_sunburst',
 ];
+/** Texture model required by texture_quality=fast and delight. */
+export const TEXTURE_MODEL_V35 = 'v3.5-20260815';
 /** texture_model whitelist (ModelPostProcessValidation.ALLOWED_TEXTURE_MODELS). */
-export const TEXTURE_MODELS = ['v3.0-20250812', 'v2.5-20250123'];
+export const TEXTURE_MODELS = [TEXTURE_MODEL_V35, 'v3.0-20250812', 'v2.5-20250123'];
 /** mesh_segmentation whitelist (ALLOWED_SEGMENT_MODELS). */
 export const SEGMENT_MODELS = ['v1.0-20250506', 'v2.0-20260430'];
 /** mesh/decimate whitelist (ALLOWED_DECIMATE_MODELS; blank/"default" → server default v2.0). */
@@ -137,9 +157,10 @@ export const TEXTURE_FORMATS = [
     'TIFF',
     'WEBP',
 ];
-export const FBX_PRESETS = ['blender', '3dsmax', 'mixamo'];
+export const FBX_PRESETS = ['blender', '3dsmax', 'mixamo', 'bake_scale'];
 export const EXPORT_ORIENTATIONS = ['+x', '-x', '+y', '-y'];
-export const TEXTURE_QUALITIES = ['standard', 'detailed', 'extreme'];
+/** `fast` only works with texture model v3.5 (other versions → 1004). */
+export const TEXTURE_QUALITIES = ['fast', 'standard', 'detailed', 'extreme'];
 /** Normalize any accepted alias to the canonical wire value; unknown values pass through. */
 export function normalizeModel(input) {
     return MODEL_ALIASES[input] ?? input;
@@ -164,7 +185,7 @@ export function chooseModel(intent) {
     return { model: MODEL_V31, reason: 'default high-fidelity → v3.1' };
 }
 /** Keywords that signal low-poly intent in a prompt (used by make/ai). */
-const LOW_POLY_HINTS = [/low[\s_-]?poly/i, /低模/, /低面/, /手游/, /voxel/i, /像素风/];
+const LOW_POLY_HINTS = [/low[\s_-]?poly/i, /低模/, /低面/, /低多边形/, /手游/, /voxel/i, /像素风/];
 export function detectLowPolyIntent(text) {
     return LOW_POLY_HINTS.some((re) => re.test(text));
 }

package/dist/knowledge/params.js

@@ -5,7 +5,7 @@
  * Every rule here prevents a guaranteed 400 or a silently wasted credit.
  * Rules marked [hard] mirror server enforcement; [soft] are CLI smart defaults.
  */
-import { CONVERT_FORMATS, DECIMATE_MODELS, EXPORT_ORIENTATIONS, FBX_PRESETS, MODEL_P2, P1_FACE_LIMIT, P1_FORBIDDEN_PARAMS, P2_FACE_LIMIT, P2_FORBIDDEN_PARAMS, TEXTURE_FORMATS, TEXTURE_QUALITIES, isP1, isP2, normalizeModel, } from './models.js';
+import { CONVERT_FORMATS, DECIMATE_MODELS, EXPORT_ORIENTATIONS, FBX_PRESETS, MODEL_P2, P1_FACE_LIMIT, P1_FORBIDDEN_PARAMS, P2_FACE_LIMIT, P2_FORBIDDEN_PARAMS, TEXTURE_FORMATS, TEXTURE_MODEL_V35, TEXTURE_QUALITIES, isP1, isP2, normalizeModel, } from './models.js';
 const PROMPT_MAX = 1024;
 const NEGATIVE_PROMPT_MAX = 255;
 /** Validate + auto-fix parameters for 3D generation (text/image/multiview-to-model). */
@@ -44,10 +44,11 @@ export function validateGenerationParams(model, input) {
         params.texture = true;
         warnings.push('pbr=true forces texture=true (adjusted)');
     }
-    // [hard] generate_parts outputs bare geometry: texture/pbr/quad must be off.
+    // [hard] generate_parts outputs bare geometry: texture/pbr/quad must be off
+    // (texture and pbr default to true server-side, so omitting them counts as on).
     if (params.generate_parts === true) {
         for (const key of ['texture', 'pbr', 'quad']) {
-            if (params[key] === true) {
+            if (key === 'quad' ? params[key] === true : params[key] !== false) {
                 params[key] = false;
                 warnings.push(`generate_parts=true disables ${key} (adjusted; run "tripo model texture" afterwards)`);
             }
@@ -88,12 +89,35 @@ export function validateGenerationParams(model, input) {
         !TEXTURE_QUALITIES.includes(params.texture_quality)) {
         errors.push(`texture_quality must be one of ${TEXTURE_QUALITIES.join('/')}`);
     }
+    applyTextureV35(params, 'texture_version', warnings, errors);
     // [hard] quad topology cannot be stored in GLB → output will be FBX.
     if (params.quad === true) {
         warnings.push('quad=true forces FBX output (quad topology cannot be stored in GLB)');
     }
     return { params, warnings, errors };
 }
+/**
+ * [hard] texture_quality=fast and delight only exist on texture model v3.5:
+ * fast on any other version is a 1004, delight is silently ignored. v3.5 is
+ * selected when no version was given. `key` is `texture_version` on the
+ * generation endpoints and `model` on /v3/models/texture.
+ */
+export function applyTextureV35(params, key, warnings, errors) {
+    const feature = params.texture_quality === 'fast' ? 'texture_quality=fast' : params.delight !== undefined ? 'delight' : undefined;
+    if (!feature)
+        return;
+    const version = params[key];
+    if (version === undefined) {
+        params[key] = TEXTURE_MODEL_V35;
+        warnings.push(`${feature} needs ${key}=${TEXTURE_MODEL_V35} (selected)`);
+    }
+    else if (version !== TEXTURE_MODEL_V35) {
+        if (feature === 'delight')
+            warnings.push(`delight is ignored unless ${key}=${TEXTURE_MODEL_V35}`);
+        else
+            errors.push(`texture_quality=fast requires ${key}=${TEXTURE_MODEL_V35} (got "${String(version)}")`);
+    }
+}
 /** Validate parameters for models/convert. */
 export function validateConvertParams(input) {
     const params = { ...input };
@@ -109,9 +133,12 @@ export function validateConvertParams(input) {
     else {
         params.format = format;
     }
-    // [hard] quad topology cannot live in GLTF/GLB.
+    // [hard] quad topology cannot live in GLTF/GLB; quad output is always FBX.
     if (params.quad === true && format === 'GLTF') {
-        errors.push('quad=true cannot export GLTF (quad topology is not storable in glTF); use FBX/OBJ/USDZ');
+        errors.push('quad=true cannot export GLTF (quad topology is not storable in glTF); quad forces FBX output — use format=FBX');
+    }
+    else if (params.quad === true && format && format !== 'FBX') {
+        warnings.push(`quad=true forces FBX output (format ${format} is overridden)`);
     }
     if (params.force_symmetry === true && params.quad !== true) {
         delete params.force_symmetry;
@@ -142,30 +169,26 @@ export function validateConvertParams(input) {
         !EXPORT_ORIENTATIONS.includes(params.export_orientation)) {
         errors.push(`export_orientation must be one of ${EXPORT_ORIENTATIONS.join('/')}`);
     }
-    // [soft] cost transparency: any non-default option upgrades billing to
-    // convert_model_complex.
-    const defaults = {
-        texture_size: 4096,
-        texture_format: 'JPEG',
-        bake: true,
-        pack_uv: false,
-        export_vertex_colors: false,
-        pivot_to_center_bottom: false,
-        scale_factor: 1,
-        with_animation: true,
-        animate_in_place: false,
-        export_orientation: '+x',
-        fbx_preset: 'blender',
-        quad: false,
-        flatten_bottom: false,
-        force_symmetry: false,
-    };
-    const complex = Object.entries(defaults).some(([k, dv]) => params[k] !== undefined && params[k] !== dv) || params.face_limit !== undefined || params.part_names !== undefined;
-    if (complex) {
+    // [soft] cost transparency.
+    if (isComplexConvert(params)) {
         warnings.push('non-default convert options use the "complex convert" price tier');
     }
     return { params, warnings, errors };
 }
+/** Pricing page: a non-default value of any of these (or any face_limit) bills the complex convert tier. */
+const COMPLEX_CONVERT_DEFAULTS = {
+    quad: false,
+    flatten_bottom: false,
+    flatten_bottom_threshold: 0.01,
+    texture_size: 4096,
+    texture_format: 'JPEG',
+    pivot_to_center_bottom: false,
+    scale_factor: 1,
+};
+export function isComplexConvert(params) {
+    return (params.face_limit !== undefined ||
+        Object.entries(COMPLEX_CONVERT_DEFAULTS).some(([k, dv]) => params[k] !== undefined && String(params[k]).toUpperCase() !== String(dv).toUpperCase()));
+}
 /**
  * Validate parameters for mesh/decimate (ModelPostProcessValidation):
  * v2.0 (default) / v3.0: face_limit 500–20000 tri / 500–10000 quad.

package/dist/knowledge/scenarios.js

@@ -2,7 +2,7 @@
  * Scenario decision matrix: --for presets and the AI wizard both read this
  * table. Changing production strategy means editing data here, not logic.
  */
-import { MODEL_P1, MODEL_V31, RIG_MODEL_V25 } from './models.js';
+import { CAPABILITY_DEFAULTS, MODEL_P1, MODEL_V31 } from './models.js';
 export const SCENARIOS = [
     {
         id: 'game-mobile',
@@ -80,13 +80,13 @@ export const SCENARIOS = [
         genParams: { texture: true, pbr: true },
         chain: [
             { step: 'rig-check', args: {} },
-            { step: 'rig', args: { model: RIG_MODEL_V25, spec: 'tripo', out_format: 'glb' } },
+            { step: 'rig', args: { model: CAPABILITY_DEFAULTS.rig, spec: 'tripo', out_format: 'glb' } },
             { step: 'retarget', args: { animations: ['preset:idle', 'preset:walk'] } },
         ],
         deliverables: ['GLB', 'FBX'],
         notes: {
-            zh: ['先 rig-check 预检,不可绑骨即止损', '接 Mixamo/Unity Humanoid 用 rig:spec=mixamo', '提示词建议 T-pose 站姿,或先 text-to-image template=t_pose'],
-            en: ['rig-check first: stop early if not riggable', 'use rig:spec=mixamo for Mixamo/Unity Humanoid', 'prompt for a T-pose, or pre-generate with text-to-image template=t_pose'],
+            zh: ['先 rig-check 预检,不可绑骨即止损', '接 Mixamo 用 rig:spec=mixamo,Unity Humanoid / Unreal 用 spec=unity / spec=unreal', '提示词建议 T-pose 站姿,或先 text-to-image template=t_pose'],
+            en: ['rig-check first: stop early if not riggable', 'use rig:spec=mixamo for Mixamo, spec=unity / spec=unreal for Unity Humanoid / Unreal', 'prompt for a T-pose, or pre-generate with text-to-image template=t_pose'],
         },
     },
     {

package/dist/pipeline/make.js

@@ -184,9 +184,9 @@ export async function executeMake(client, plan, options) {
         notify: false,
         timeoutMs: options.timeoutMs,
     });
-    // If the chain stopped early (not riggable) and nothing was downloaded yet,
+    // If the chain stopped early (not riggable) and no step downloaded a model,
     // fetch the source artifacts so the user still gets their model.
-    if (stoppedEarly && plan.generation && !options.noDownload) {
+    if (stoppedEarly && plan.generation && !options.noDownload && !results.some((r) => r.model_file)) {
         const detail = await client.getTask(sourceTaskId);
         const { downloadArtifacts, defaultOutputDir } = await import('../core/download.js');
         const { slugify } = await import('../config/history.js');

package/dist/pipeline/runner.js

@@ -9,12 +9,14 @@ import { buildStepRequest } from '../core/requests.js';
 import { runTask } from '../core/task-service.js';
 import { t } from '../i18n.js';
 import { getStep, validateChain } from '../knowledge/chains.js';
+import { NON_BIPED_PRESETS } from '../knowledge/models.js';
 export async function runChain(options) {
     const { client, chain } = options;
     validateChain(chain, options.sourceType);
     const results = [];
     let currentTaskId = options.sourceTaskId;
     let rigTypeRecommendation;
+    let rigType;
     for (let i = 0; i < chain.length; i++) {
         const spec = chain[i];
         const args = { ...spec.args };
@@ -22,6 +24,20 @@ export async function runChain(options) {
             args.rig_type = rigTypeRecommendation;
             log(t({ zh: `采用 rig-check 推荐体型:${rigTypeRecommendation}`, en: `using rig-check recommendation: ${rigTypeRecommendation}` }));
         }
+        if (spec.step === 'rig')
+            rigType = String(args.rig_type ?? 'biped');
+        // Biped presets (preset:<name>) do not fit other bodies: use that rig type's own preset.
+        const bodyPresets = rigType ? NON_BIPED_PRESETS[rigType] : undefined;
+        if (spec.step === 'retarget' && bodyPresets) {
+            const requested = [args.animations ?? args.animation ?? []].flat().map(String);
+            if (requested.length > 0 && requested.every((a) => /^preset:[^:]+$/.test(a))) {
+                delete args.animation;
+                args.animations = bodyPresets;
+                log(t({ zh: `体型为 ${rigType},双足预设换成 ${bodyPresets.join(', ')}`, en: `rig type is ${rigType}: biped presets swapped for ${bodyPresets.join(', ')}` }));
+            }
+        }
+        // avian/others have no preset animations: the rigged model is the final output.
+        const noPresets = spec.step === 'rig' && chain[i + 1]?.step === 'retarget' && rigType !== 'biped' && !bodyPresets;
         const built = buildStepRequest(spec.step, currentTaskId, args);
         for (const w of built.warnings)
             warn(w);
@@ -34,10 +50,18 @@ export async function runChain(options) {
             notify: false,
             timeoutMs: options.timeoutMs,
             // Intermediate steps skip download; final step downloads.
-            noDownload: i < chain.length - 1 && spec.step !== 'rig-check',
+            noDownload: i < chain.length - 1 && spec.step !== 'rig-check' && !noPresets,
             precheckBalance: false, // checked once by the caller
         });
         results.push(result);
+        if (noPresets) {
+            const message = t({
+                zh: `体型 ${rigType} 没有预设动画,已跳过 retarget,产物为绑骨模型`,
+                en: `rig type ${rigType} has no preset animations; skipped retarget and kept the rigged model`,
+            });
+            warn(message);
+            return { results, stoppedEarly: message };
+        }
         if (spec.step === 'rig-check') {
             const verdict = await client.getTask(result.task_id);
             const output = verdict.output ?? {};

package/dist/util/input-detect.js

@@ -59,7 +59,7 @@ export function classifyInputs(args) {
             case 'url':
                 if (detected.length > 1)
                     return { kind: 'multiview', values: detected };
-                return { kind: 'url-image', values: detected };
+                return { kind: MODEL_EXTS.has(urlExtension(detected[0].value)) ? 'model' : 'url-image', values: detected };
             case 'task-id':
             case 'history-ref':
             case 'file-token':
@@ -76,6 +76,15 @@ export function classifyInputs(args) {
 }
 export class InputDetectError extends Error {
 }
+/** Lower-cased extension of a URL's path ('' when it has none). */
+export function urlExtension(url) {
+    try {
+        return extname(new URL(url).pathname).toLowerCase();
+    }
+    catch {
+        return '';
+    }
+}
 function isExistingFile(p) {
     try {
         return existsSync(p) && statSync(p).isFile();

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "tripo-cli",
-  "version": "0.7.1",
+  "version": "0.7.3",
   "description": "Tripo 3D intelligent CLI — turn a prompt or an image into engine-ready 3D assets from your terminal (Tripo V3 API)",
   "keywords": [
     "tripo",

package/skill/SKILL.md

@@ -3,6 +3,13 @@
 You (an AI coding agent) can generate production-ready 3D assets with the `tripo` CLI.
 One command turns a text prompt or an image into local files: a 3D model (glb/fbx/stl/...), a `preview.png` render, and a `task.json` record.
 
+When the calling host is known, set `TRIPO_CLIENT_APP` to its actual name
+(`codex`, `workbuddy`, `zcode`, `kimi`, `deepseek`, `claude`, `cursor`, or `chatgpt`) on each
+CLI command, including every command in a pipeline. Do not guess from the model,
+API key, account region, or an earlier call. Set `TRIPO_DISTRIBUTION_CHANNEL` only
+when a packaged plugin provides it; a standalone CLI install is not a plugin.
+These values are per-call metadata, never account-profile settings.
+
 ## Install & auth
 
 ```bash
@@ -22,17 +29,20 @@ login only works on the site it was started for.
 - no account yet: mainland China → `cn`, everywhere else → `ov`
 
 ```bash
-tripo login --region <cn|ov>    # the site the human named
+tripo login --region <cn|ov> --no-wait    # the site the human named
 ```
 
-It prints a verification URL and a one-time code, then blocks until the human
-approves in a browser (up to ~15 minutes — do not kill it early). Relay the URL
-and code to the human and tell them: sign in on that page first if it asks
+It prints a verification URL and a one-time code and exits at once. Relay the
+URL and code to the human and tell them: sign in on that page first if it asks
 (sign-up gives free credits), enter the code, pick an API key if the account has
-several (one is created automatically if there are none), click Authorize. The
+several (one is created automatically if there are none), click Authorize. When
+they say it is done, run the same command again: it finishes the login with that
+same code (`"status":"logged_in"`), or answers `"status":"pending"` if they have
+not authorized yet. Without `--no-wait` the command itself waits for the approval
+(up to ~15 minutes); if it gets cut off, rerunning resumes the same code. The
 key is then saved locally; never ask the human to paste a key into the chat. If
 the code expires (exit 3), just run the same command again; if the human says
-the page is the wrong site, stop it and rerun with the other `--region`.
+the page is the wrong site, rerun with the other `--region`.
 
 Regions (ov = international, cn = China mainland) share one CLI: `tripo login --key tsk_...` auto-detects which region the key belongs to. Already logged into the wrong site? `tripo login --region <other>` replaces the active profile's key and region. On exit code 3 (auth), run `tripo doctor` — it diagnoses key-vs-region mismatches and prints the exact fix (`tripo config set region cn|ov`).
 
@@ -58,9 +68,10 @@ tripo make @last --then convert:fbx --json --yes          # continue from last t
 ```
 
 - `--for` scenario presets: `game-mobile` `game-pc` `film` `print` `ar-web` `anim` `toy`
-- `--then` chain steps: `refine texture convert import rig-check rig retarget segment complete decimate uv smartsegment`
+- `--then` chain steps: `texture convert import rig-check rig retarget segment complete decimate uv smartsegment`
   - step args: `convert:format=FBX,texture_size=2048` (bare value = primary arg: `convert:fbx`, `decimate:5000`)
-- Output JSON: `{"task_id","type","status","credits_consumed","output_dir","files",["model_file"],["preview"],["chain"],["credits_breakdown"]}` — with `--then`, `credits_consumed` is the **total** for the run and `credits_breakdown` itemizes every task (`[{task_id,type,credits_consumed}]`, generation first)
+- Output JSON: `{"task_id","type","status","credits_consumed","output_dir","files",["model_file"],["preview"],["normalize_scale"],["chain"],["credits_breakdown"]}` — with `--then`, `credits_consumed` is the **total** for the run and `credits_breakdown` itemizes every task (`[{task_id,type,credits_consumed}]`, generation first)
+  - `normalize_scale` appears when the input was a model file / URL: the import rescaled it (final size = original size × normalize_scale; `1` = untouched) and nothing scales it back — divide by it to recover the original size
 
 ## Pipes (composing steps yourself)
 

package/skill/commands/account.md

@@ -8,13 +8,18 @@ export TRIPO_API_KEY=tsk_...     # zero interaction when a key is already provis
 tripo login                      # humans in a terminal: interactive browser flow
 tripo login --region ov|cn       # agents/CI without a key: headless device flow — prints a
                                  # verification URL + one-time code on stderr, waits for the
-                                 # human to authorize in a browser (≤15 min), saves the key
+                                 # human to authorize in a browser (≤15 min), saves the key;
+                                 # rerunning after an interruption resumes the same code
+tripo login --region ov|cn --no-wait
+                                 # chat agents: print the URL + code and exit at once; rerun
+                                 # it after the human authorizes → "logged_in" (or "pending")
 tripo login --key tsk_... --region ov|cn
 tripo whoami                     # masked key + active profile + region + balance
 tripo logout                     # removes the local key of the active profile only
 ```
 
 Region decides the API host: ov → `openapi.tripo3d.ai`, cn → `openapi.tripo3d.com`.
+`tripo login` probes both regions with the key and stores the right one; a key from `TRIPO_API_KEY` is **not** probed — a China-region key also needs `TRIPO_REGION=cn`.
 
 ## Multiple accounts (profiles)
 
@@ -35,7 +40,7 @@ tripo topup        # opens the billing page, then polls until credits arrive
 ```
 
 Exit code 4 anywhere = insufficient credits → tell the human to run `tripo topup`.
-Failed tasks refund their frozen credits automatically.
+Failed / cancelled tasks refund their frozen credits automatically.
 
 ## Config
 

package/skill/commands/generate.md

@@ -9,6 +9,7 @@ Everything below is the full parameter reference from the official API docs —
 tripo generate text-to-model "a ceramic teapot" [--model tripo-v3.1|tripo-p1|tripo-p2] [-p face_limit=15000] ...
 tripo generate image-to-model photo.png [-p texture_alignment=original_image] [-p orientation=align_image]
 tripo generate multiview-to-model front.png back.png [left.png right.png]
+tripo generate multiview-to-model @last          # reuse the 4 views of an image-to-multiview / edit-multiview task
 ```
 
 ### P Series (`tripo-p1` / `tripo-p2`) — same endpoints, different model
@@ -36,7 +37,7 @@ Keywords: model versions · H series (v3.x) · P series (P1 / P2) · Preview ·
 | alias (what you type) | wire value (what the API receives) | status | positioning | notes |
 | --- | --- | --- | --- | --- |
 | `tripo-v3.1` (default) | `v3.1-20260211` | GA | latest high-precision; AAA / 3D printing | full feature set |
-| `tripo-p1` | `P1-20260311` | GA | best low-poly; games / UGC / mobile | face_limit 48–20000 (CLI enforces ≥50); **no** `quad` `smart_low_poly` `generate_parts` `geometry_quality`; ~2s mesh; extra `export_uv` |
+| `tripo-p1` | `P1-20260311` | GA | best low-poly; games / UGC / mobile | face_limit 50–20000; **no** `quad` `smart_low_poly` `generate_parts` `geometry_quality`; ~2s mesh |
 | `tripo-p2` | `P2-20260801` | **Preview** (2026-08) | P1 upgrade (P series) | adds `quad` (forces FBX); face_limit 48–50000 tri / 48–25000 quad (validated locally); still **no** `smart_low_poly` `generate_parts` `geometry_quality` (stripped with a warning); credits 100 (no texture) / 110 / 120 / 130 for standard / detailed / extreme. Explicit `--model` only — the CLI never auto-selects it |
 | `tripo-v3.0` / `tripo-v2.5` | `v3.0-20250812` / `v2.5-20250123` | Legacy | previous generations | only when the human asks |
 
@@ -56,10 +57,12 @@ Official docs (ov / cn):
 | `input` | — | image | `file_` token, `http(s)://` URL or `task_` id (e.g. a text-to-image task) — the CLI uploads local files for you |
 | `inputs` | — | multiview | see "multiview inputs" below |
 | `model_seed` / `image_seed` / `texture_seed` | random | all | geometry / text-to-image stage / texture seeds — the key to reproducibility (`task.json` records them) |
-| `face_limit` | adaptive | all | max polycount; P1 48–20000, P2 48–50000 |
+| `face_limit` | adaptive | all | max polycount; P1 50–20000, P2 48–50000 (quad 48–25000) |
 | `texture` | `true` | all | set `false` for bare geometry (print / re-texture later) — saves credits |
 | `pbr` | `true` | all | PBR maps; **forces `texture=true`** |
-| `texture_quality` | `standard` | all | `standard` / `detailed` / `extreme` (price tiers) |
+| `texture_quality` | `standard` | all | `fast` (texture v3.5 only, same price as standard) / `standard` / `detailed` / `extreme` (8K, extra credits) |
+| `texture_version` | derived from `model` | all | texture model, decoupled from geometry: `v3.5-20260815` (latest) / `v3.0-20250812` (v3.x and P default) / `v2.5-20250123`. Required by `fast` and `delight` — the CLI fills in v3.5 when you omit it; `fast` with another version is rejected locally |
+| `delight` | `true` | all | remove lighting baked into the reference before texturing; `false` keeps the original shading. Texture v3.5 only (older versions ignore it) |
 | `geometry_quality` | `standard` | v3.x | `detailed` = Ultra mode (extra HD credit) |
 | `auto_size` | `false` | all | scale to real-world metres |
 | `quad` | `false` | v3.x, P2 | quad mesh; **forces FBX output** (quads cannot live in GLB) |
@@ -67,7 +70,7 @@ Official docs (ov / cn):
 | `generate_parts` | `false` | v3.x | editable segmented parts — see rules below |
 | `compress` | — | v3.x | `geometry` = meshopt compression |
 | `export_orientation` | `+x` | all | forward axis `+x` / `-x` / `+y` / `-y` — see warning below |
-| `export_uv` | `true` | P series only | `false` = faster, smaller file (no UV unwrap) |
+| `export_uv` | `true` | all | `false` = faster, smaller file (UVs are unwrapped at the texture stage instead) |
 | `enable_image_autofix` | `false` | image | auto-repair low-quality inputs |
 | `texture_alignment` | `original_image` | image, multiview | `original_image` (match the picture) / `geometry` (match the mesh) |
 | `orientation` | `default` | image, multiview | `align_image` = align the model to the input viewpoint |
@@ -88,13 +91,14 @@ The API accepts three `inputs` shapes (never mix them):
 - **legacy positional**: exactly 4 strings `[front, left, back, right]`, `""` skips a slot.
 - **task_id**: `[{"task_id":"<image-to-multiview or edit-multiview task>"}]` to reuse a 4-view sheet (source task must be `success`).
 
-The CLI builds view-key payloads from your files: filename hints (`front|back|left|right`, or 正面/背面/左/右) win; otherwise positional order front, left, back, right. A front view is mandatory.
+The CLI builds view-key payloads from your files: filename hints (`front|back|left|right`, or 正面/背面/左/右) win; otherwise positional order front, left, back, right. A front view is mandatory. A single task id / `@ref` argument is sent in the task_id shape instead (a `@ref` of another task type is rejected locally).
 
 ## Images (2D pipeline before 3D)
 
 ```bash
 tripo generate text-to-image "front view of a knight, T-pose" [-p template=t_pose] [--model seedream_v4]
 tripo generate image-to-image sketch.png --prompt "make it look like clay" [--model seedream_v5]
+tripo generate image-to-image hero.png outfit.png --prompt "the character from image[1] wearing the outfit from image[2]"
 tripo generate image-to-multiview photo.png     # 1 image → 4-view sheet
 tripo generate edit-multiview <multiview-task-id> -p 'prompts=[{"view":"front","prompt":"add a sword"}]'
 tripo generate image-to-splat photo.png         # gaussian splat
@@ -106,9 +110,10 @@ tripo generate image-to-splat photo.png         # gaussian splat
 | --- | --- | --- | --- |
 | `seedream_v4` | ByteDance | GA | text-to-image default (balanced); **not accepted by image-to-image** |
 | `seedream_v5` | ByteDance | GA | image-to-image default; higher quality |
-| `gemini-2.5-flash` / `gemini-3-pro` / `gemini-3.1-flash` | Google | GA | fast / high quality / latest fast. Backend aliases `banana` / `banana_pro` / `banana2` are also accepted |
-| `chat_image_1` / `chat_image_1.5` | OpenAI | retiring 2026-10-23 / 2026-12-01 | GPT image; 1.5 = higher quality — move to `chat_image_2` |
-| `chat_image_2` | OpenAI | GA | GPT latest |
+| `banana` / `banana_pro` / `banana2` | Google | GA | fast / higher quality / latest fast |
+| `chat_image_1` / `chat_image_1.5` | OpenAI | retiring 2026-10-23 / 2026-12-01 | GPT image; 1.5 = higher quality — move to `chat_image_2` or 2.5 |
+| `chat_image_2` | OpenAI | GA | GPT, best quality |
+| `chat_image_2.5_flare` / `chat_image_2.5_sunburst` | OpenAI | GA | 2.5 series: flare = speed tier (chat_image_2 quality, much faster); sunburst = refined tier (keeps unedited areas closest to the original) |
 
 Image model ids are sent as-is (no alias normalization). Full list with retirement dates: <https://developers.tripo3d.ai/en/docs/models-and-versions>.
 
@@ -117,15 +122,19 @@ Image model ids are sent as-is (no alias normalization). Full list with retireme
 | param | default | endpoint | notes |
 | --- | --- | --- | --- |
 | `prompt` | — | t2i (required), i2i | ≤1024 chars; i2i: required unless `template` is set |
-| `input` | — | i2i, i2mv, edit-mv, splat | `file_` token / URL (i2i also accepts a `task_` id) |
-| `inputs` | — | i2i | multiple reference images: seedream ≤4, gemini ≤10 (gpt ≤16); reference them in the prompt as `[image 1]`, `[image 2]`… |
-| `template` | — | t2i, i2i | `asset_extraction` `character_completion` `t_pose` `head_extraction` `3d_enhance` `variants` `print_clay` `figure` |
-| `t_pose` | `false` | t2i, i2i | boolean shortcut: convert the subject to a T-pose |
-| `sketch_to_render` | `false` | t2i, i2i | turn a sketch into a rendered image |
+| `input` | — | i2i, i2mv, edit-mv, splat | `file_` token / URL (i2i also accepts a `task_` id); i2i: JPEG/PNG ≤20 MB, ≤36 MP |
+| `inputs` | — | i2i | multiple reference images (the CLI sends this when you pass several images): seedream ≤4, banana ≤10, chat_image ≤16; cite them in the prompt as `image[1]`, `image[2]`… |
+| `template` | — | t2i, i2i | t2i: `asset_extraction` `character_completion` `t_pose` `variants` `figure`; i2i: `t_pose` `character_completion` `3d_enhance` `variants` `figure` |
+| `size` | `2048x2048` | t2i, i2i | keyword (`2K` / `4K`) or exact pixels; accepted values differ per model |
+| `quality` | `low` | t2i, i2i | `chat_image_2`: `low` `medium` `high`; `chat_image_2.5_*`: also `xhigh` `max` (no `auto`). Other models reject it. `high` and above cost more credits |
+| `background` | model decides | t2i, i2i | `chat_image_2.5_*` only (ignored elsewhere): `auto` / `opaque` / `transparent`; `transparent` requires `output_format=png` |
+| `aspect_ratio` | `1:1` | t2i, i2i | banana family only: `1:1 2:3 3:2 3:4 4:3 4:5 5:4 9:16 16:9 21:9` (banana2 adds `1:8 1:4 4:1 8:1`); seedream / chat_image use `size` |
+| `output_format` | `png` | t2i, i2i | `png` (lossless, alpha) / `jpeg` (smaller, no alpha) |
+| `watermark` | `false` | t2i | AI-content watermark, seedream only (banana always embeds an invisible one; chat_image has no control) |
 | `model_seed` | random | splat | same seed + same image = repeatable `.splat` |
 
-- `template=t_pose` (or `t_pose=true`) is the golden pre-step for the animation pipeline; `3d_enhance` cleans a photo before image-to-model; `print_clay` previews a single-colour print look.
-- Sizes are billed in 1K / 2K / 4K tiers; `aspect_ratio` is only honoured by the gemini family.
+- `template=t_pose` is the golden pre-step for the animation pipeline; `3d_enhance` (i2i) cleans a photo before image-to-model.
+- Sizes are billed in 1K / 2K / 4K tiers.
 - `image-to-multiview` output: `front_view_url` `left_view_url` `back_view_url` `right_view_url` — feed them (or the task id, see above) to `multiview-to-model`.
 - `edit-multiview` takes a successful `image-to-multiview` task; `prompts` is 1–4 `{view, prompt}` objects.
 - `image-to-splat` returns a `.splat` file in `output.model_url` (not a mesh — no texture / rig / convert downstream). Fixed **30 credits**, ~4 minutes. Input PNG / JPEG / WebP ≤20 MB, ≥256×256 px, subject clear and centred. Use image-to-model when you need an editable mesh.

package/skill/commands/make.md

@@ -34,13 +34,13 @@ In a TTY it then asks `Run this plan?`; answering no exits 0 with `cancelled; no
 | quoted text | text-to-model |
 | one image (.png/.jpg/.jpeg/.webp/.bmp) or image URL | image-to-model |
 | 2–4 images | multiview-to-model (filename hints front/back/left/right win; otherwise positional front,left,back,right; front required) |
-| a model file (.glb/.gltf/.fbx/.obj/.stl) | import (add --then for processing) |
+| a model file or model URL (.glb/.gltf/.fbx/.obj/.stl) | import (add --then for processing) |
 | task id / `@last` / `@name` | continue processing from that task (--then required) |
 
 ## Options
 
 - `--for <scenario>` — `game-mobile` `game-pc` `film` `print` `ar-web` `anim` `toy`. Sets model+params+chain+format from the domain knowledge base.
-- `--then <steps>` — processing chain, comma-separated. Steps: `refine texture convert import rig-check rig retarget segment complete decimate uv smartsegment`. Args: `step:key=value,...`; bare value maps to the step's primary arg (`convert:fbx` → format, `decimate:5000` → face_limit, `retarget:preset:walk` → animation). Overrides the scenario chain.
+- `--then <steps>` — processing chain, comma-separated. Steps: `texture convert import rig-check rig retarget segment complete decimate uv smartsegment`. Args: `step:key=value,...`; bare value maps to the step's primary arg (`convert:fbx` → format, `decimate:5000` → face_limit, `retarget:preset:walk` → animation). Overrides the scenario chain.
 - `--model <m>` — force `tripo-v3.1` (high fidelity, default), `tripo-p1` (low-poly; face_limit 50–20000; quad/parts/geometry_quality unsupported and stripped) or `tripo-p2` (P-series preview; adds quad, face_limit 48–50000 tri / 48–25000 quad; never auto-selected). The CLI normalizes these aliases to the wire versions (`v3.1-20260211` / `P1-20260311` / `P2-20260801`) the server actually accepts. Full table with status (GA / Preview / Legacy) and official links: `tripo docs --topic commands/generate` → "Models & Versions".
 - `-n, --candidates <n>` — up to 4 parallel candidates with different seeds (interactive pick when chaining).
 - `--seed <n>` — fixed model_seed for reproducible geometry.
@@ -69,7 +69,7 @@ tripo make concept.png --for game-mobile --then rig,convert:fbx --dry-run --json
  "steps":[
    {"name":"image-to-model","endpoint":"/v3/generation/image-to-model","task_type":"image_to_model",
     "payload":{"input":"<upload:concept.png>","model":"P1-20260311","texture":true,"pbr":true,"texture_quality":"standard","face_limit":15000}},
-   {"name":"rig","endpoint":"/v3/animations/rig","task_type":"animate_rig","payload":{"input":"<upstream>","model":"v2.5-20260210"}},
+   {"name":"rig","endpoint":"/v3/animations/rig","task_type":"animate_rig","payload":{"input":"<upstream>","model":"v3.0-20260909"}},
    {"name":"convert","endpoint":"/v3/models/convert","task_type":"convert_model","payload":{"input":"<upstream>","format":"FBX"}}],
  "pending_uploads":["concept.png"],
  "deliverables":["FBX","GLB"],
@@ -103,6 +103,7 @@ Typical agent loop: dry-run → fix `errors` / adjust params → dry-run again u
 ```
 
 - Single task (no `--then`): `credits_consumed` is that task's spend; no `credits_breakdown`.
+- Model file / URL input: the result adds `normalize_scale`, the factor the import rescaled the model by (final size = original size × normalize_scale; `1` = untouched). The platform never scales it back; divide by it to recover the original size. With `--then`, the steps after the import do not return it, so the result carries the import's value.
 - Chained run: `credits_consumed` is the **total** across generation + every step, and `credits_breakdown` lists each task in run order (generation first). Human mode prints the same as `credits consumed (total): 145` followed by one indented line per task.
 
 Exit codes: 0 ok · 2 params · 3 auth · 4 credits · 5 content policy · 6 task failed · 7 network · 9 rate limit.