# AI3D API v2 model: tripo-convert

Convert an existing 3D model to another file format with Tripo's convert endpoint.

- AI3D model ID: `tripo-convert` (native Tripo API, `models/convert`)
- Task: `model_to_model`
- Provider adapter: `tripo`
- Availability: listed in `GET /v2/models` only once Tripo operations are enabled on the deployment. Until then `POST /v2/jobs` returns `400 unknown model`.
- Provider reference: <https://developers.tripo3d.ai/en/docs/models-convert>

Create a normal prepaid AI3D job. Do not call Tripo directly or put a provider key in a client.

```http
POST https://api.ai3d.dev/v2/jobs
Authorization: Bearer <AI3D_API_KEY>
Content-Type: application/json
Idempotency-Key: <unique-request-id>
```

```json
{
  "model": "tripo-convert",
  "source_job_id": "3f6c0e2e-6a3f-4f1e-9d0c-1b2a3c4d5e6f",
  "input": {
    "format": "FBX"
  }
}
```

Source model: send exactly one of these top-level fields. Do not put them inside `input`.

- `source_job_id`: the UUID of your own completed Tripo job (`tripo-h31-image`, `tripo-h31-text`, `tripo-p1-image`, `tripo-p1-text`, or `tripo-p1-multiview`).
- `model_url`: a public HTTPS link to a GLB, GLTF, FBX, OBJ, or STL file (up to 150 MB at Tripo). AI3D does not fetch it; Tripo does. URL input is not verified for this operation; prefer `source_job_id`.

Jobs created by Fal-hosted Tripo models or any other provider cannot be used as `source_job_id` and return 422. Use `model_url` instead; for a public GLB or GLTF job you can pass its public viewer artifact URL.

`input.format` is required: `GLTF`, `FBX`, `USDZ`, `OBJ`, `STL`, or `3MF` (case-insensitive, stored upper case). Optional settings: `quad`, `force_symmetry` (needs `quad: true`), `face_limit` (1 to 2,000,000), `flatten_bottom`, `flatten_bottom_threshold` (0 or more), `texture_size` (64 to 8192), `texture_format` (`JPEG`, `PNG`, `WEBP`, `BMP`, `DPX`, `HDR`, `OPEN_EXR`, `TARGA`, or `TIFF`), `bake`, `pack_uv`, `export_vertex_colors` (only for `OBJ` or `GLTF`), `pivot_to_center_bottom`, `scale_factor` (above 0, up to 1000), `with_animation`, `animate_in_place`, `export_orientation` (`+x`, `-x`, `-y`, or `+y`), and `fbx_preset` (`blender`, `3dsmax`, `mixamo`, or `bake_scale`). `quad: true` forces FBX output at Tripo.

Reserve (an upper bound, in Tripo credits at $0.01 each):

| Request | Credits | USD |
| --- | --- | --- |
| `format` only | 5 | 0.05 |
| `format` plus any other option | 10 | 0.10 |

AI3D reserves before dispatch and settles against Tripo's reported credits, never more than the reserve. A job that fails at Tripo is not charged.

Errors: `404` source job not found (also returned for another account's job), `409` source job has not completed successfully, `422` invalid settings or a source job that cannot be used. Failed jobs report `provider_input_invalid`, `provider_request_rejected`, or `provider_insufficient_credits`.

Output: the converted file is archived in `artifacts`. FBX, OBJ, STL, USDZ, and 3MF results are download-only (no in-browser viewer); GLTF results can be previewed. Poll `GET /v2/jobs/{job_id}` until `succeeded`, `failed`, or `submission_unknown`. Use the same idempotency key when safely retrying a timed-out request.