Meshy Text to 3D API

The Text to 3D API from Meshy — 3 operation(s) for text to 3d.

Operations 5

POST /openapi/v2/text-to-3d Create a Text-to-3D task (preview or refine mode)
GET /openapi/v2/text-to-3d List Text-to-3D tasks (paginated)
GET /openapi/v2/text-to-3d/{id} Retrieve a Text-to-3D task
DELETE /openapi/v2/text-to-3d/{id} Delete a Text-to-3D task
GET /openapi/v2/text-to-3d/{id}/stream Stream real-time task updates via SSE

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this
  • find_apisBrowse and filter every API in the catalog.
  • get_api_artifactsOne API's artifacts, grouped by type.
  • get_openapiThe primary OpenAPI for this API.
  • find_similar_apisAPIs that look like this one.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This API
curl "https://apis.io/api/v1/apis/meshy-text-to-3d-api"
All apis
curl "https://apis.io/api/v1/apis?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

meshy-text-to-3d-api-openapi.yml Raw ↑
openapi: 3.2.0
info:
  title: Meshy Text to 3D API
  description: 'Meshy is an AI 3D model generation platform. The REST API at https://api.meshy.ai

    provides Text-to-3D (v2 preview + refine workflow), Image-to-3D, and related

    asset generation operations. Authentication is via bearer token.

    '
  version: '2.0'
  contact:
    name: Meshy
    url: https://docs.meshy.ai/
servers:
- url: https://api.meshy.ai
  description: Production API
security:
- bearerAuth: []
tags:
- name: Text to 3D
paths:
  /openapi/v2/text-to-3d:
    post:
      tags:
      - Text to 3D
      summary: Create a Text-to-3D task (preview or refine mode)
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/TextTo3DRequest'
      responses:
        '202':
          description: Task accepted
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/TaskCreated'
    get:
      tags:
      - Text to 3D
      summary: List Text-to-3D tasks (paginated)
      parameters:
      - in: query
        name: page_num
        schema:
          type: integer
          default: 1
      - in: query
        name: page_size
        schema:
          type: integer
          default: 10
      responses:
        '200':
          description: List of tasks
          content:
            application/json:
              schema:
                type: array
                items:
                  $ref: '#/components/schemas/Task'
  /openapi/v2/text-to-3d/{id}:
    parameters:
    - in: path
      name: id
      required: true
      schema:
        type: string
    get:
      tags:
      - Text to 3D
      summary: Retrieve a Text-to-3D task
      responses:
        '200':
          description: Task details
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Task'
    delete:
      tags:
      - Text to 3D
      summary: Delete a Text-to-3D task
      responses:
        '200':
          description: Deleted
  /openapi/v2/text-to-3d/{id}/stream:
    parameters:
    - in: path
      name: id
      required: true
      schema:
        type: string
    get:
      tags:
      - Text to 3D
      summary: Stream real-time task updates via SSE
      responses:
        '200':
          description: Server-Sent Events stream
          content:
            text/event-stream: {}
components:
  schemas:
    Task:
      type: object
      properties:
        id:
          type: string
        status:
          type: string
          enum:
          - PENDING
          - IN_PROGRESS
          - SUCCEEDED
          - FAILED
          - CANCELED
          - EXPIRED
        progress:
          type: integer
        created_at:
          type: integer
        finished_at:
          type: integer
        model_urls:
          type: object
          additionalProperties:
            type: string
        thumbnail_url:
          type: string
        prompt:
          type: string
        consumed_credits:
          type: integer
    TaskCreated:
      type: object
      properties:
        result:
          type: string
          description: Task ID
    TextTo3DRequest:
      type: object
      required:
      - mode
      properties:
        mode:
          type: string
          enum:
          - preview
          - refine
        prompt:
          type: string
          maxLength: 600
        preview_task_id:
          type: string
          description: Required when mode is "refine"
        model_type:
          type: string
          enum:
          - standard
          - lowpoly
        ai_model:
          type: string
          enum:
          - meshy-5
          - meshy-6
          - latest
        pose_mode:
          type: string
          enum:
          - a-pose
          - t-pose
          - ''
        enable_pbr:
          type: boolean
        texture_prompt:
          type: string
          maxLength: 600
        target_formats:
          type: array
          items:
            type: string
            enum:
            - glb
            - obj
            - fbx
            - stl
            - usdz
            - 3mf
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      description: 'API key supplied as `Authorization: Bearer YOUR_API_KEY`'