Skip to main content
ArtEmotion
3D

TripoSR

Credit-based pricing. Supports reference images.

TripoSR preview
Output
3D mesh

Inputs

  • Reference image (required)

Example prompt

A heroic space marine in heavy gold and charcoal exo-suit armor with glowing orange energy cells
Try this prompt →
LLM-ready

API & LLM schema

Exact request contract for this model. Agents can fetch it from /api/v1/models?id=fal-ai/triposr.

POST/api/v1/generate12 fields · 3 required
FieldTypeRequirementContract
model_idconstantRequiredArtEmotion model identifier.
extraobjectOptionalModel-specific settings may also be nested here.
max_creditsnumberOptionalReject before submission if the estimated list price exceeds this cap. · Range: 1–…
webhook_urlstringOptionalFormat: uri
webhook_secretstringOptionalOptional model input.
folder_idstringOptionalOptional model input.
promptstringRequiredOptional model input.
output_formatstringOptionalOutput format for the 3D model. · Allowed: glb, obj · Default: glb
foreground_rationumberOptionalRatio of the image occupied by the foreground object. Higher values zoom in on the subject. · Default: 0.9 · Range: 0.5–1
mc_resolutionnumberOptionalResolution of the marching cubes. Above 512 is not recommended. · Default: 256 · Range: 32–1024
do_remove_backgroundbooleanOptionalWhether to remove the background from the input image. · Default: true
reference_image_urlstringRequiredFormat: uri
Minimal request example
{
  "model_id": "fal-ai/triposr",
  "prompt": "A heroic space marine in heavy gold and charcoal exo-suit armor with glowing orange energy cells",
  "reference_image_url": "https://example.com/reference_image"
}
Raw JSON Schema
{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://www.artemotion.ai/api/v1/models?id=fal-ai%2Ftriposr",
  "title": "TripoSR generation request",
  "description": "Request body accepted by POST /api/v1/generate for fal-ai/triposr.",
  "type": "object",
  "properties": {
    "model_id": {
      "type": "string",
      "const": "fal-ai/triposr",
      "description": "ArtEmotion model identifier."
    },
    "extra": {
      "type": "object",
      "additionalProperties": true,
      "description": "Model-specific settings may also be nested here."
    },
    "max_credits": {
      "type": "number",
      "minimum": 1,
      "description": "Reject before submission if the estimated list price exceeds this cap."
    },
    "webhook_url": {
      "type": "string",
      "format": "uri",
      "maxLength": 2048
    },
    "webhook_secret": {
      "type": "string",
      "maxLength": 512
    },
    "folder_id": {
      "type": "string"
    },
    "prompt": {
      "type": "string"
    },
    "output_format": {
      "title": "Output Format",
      "description": "Output format for the 3D model.",
      "default": "glb",
      "type": "string",
      "enum": [
        "glb",
        "obj"
      ]
    },
    "foreground_ratio": {
      "title": "Foreground Ratio",
      "description": "Ratio of the image occupied by the foreground object. Higher values zoom in on the subject.",
      "default": 0.9,
      "type": "number",
      "minimum": 0.5,
      "maximum": 1
    },
    "mc_resolution": {
      "title": "MC Resolution",
      "description": "Resolution of the marching cubes. Above 512 is not recommended.",
      "default": 256,
      "type": "number",
      "minimum": 32,
      "maximum": 1024,
      "multipleOf": 1
    },
    "do_remove_background": {
      "title": "Remove Background",
      "description": "Whether to remove the background from the input image.",
      "default": true,
      "type": "boolean"
    },
    "reference_image_url": {
      "type": "string",
      "format": "uri"
    }
  },
  "required": [
    "model_id",
    "prompt",
    "reference_image_url"
  ],
  "additionalProperties": false
}

FAQ

How much does TripoSR cost on ArtEmotion?

Credit-based pricing. You pay in ArtEmotion credits — every plan and top-up converts USD to credits at a fixed rate.

Do I get my credits back if TripoSR fails?

Yes — failed generations are never charged. The credits are released back to your balance automatically.

Can I call TripoSR from the API?

Yes. Use POST /api/v1/generate with model_id: "fal-ai/triposr". See the API reference for the full schema.

Where are my generations stored?

Every output is saved to your personal Library. You can export or delete everything any time from Privacy & deletion.

Ready to generate with TripoSR?

Start now →

No commitment. New accounts get 50 free credits on signup. See pricing.