V2Fun API Docs

English

简体中文

English

简体中文

Appearance

Render Preview ​

Provide rapid visual feedback for 3D assets. Generate high-definition thumbnails from multiple angles with standard lighting without opening heavy professional modeling software.

Typical Application Scenarios ​

  • Asset Library Management: Automatically generate standardized thumbnail previews for massive 3D libraries.
  • Web Rapid Preview: Showcase model details through static images without needing to load a full 3D engine.

API Reference used on this page POST /3d_models/renderings

Basic Examples ​

bash
curl -X POST 'https://api.v2fun.ai/api/v1/3d_models/renderings' \
  -H 'Authorization: Bearer $V2FUN_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{
      "input_model": "models/example.glb"
    }'
javascript
const response = await fetch('https://api.v2fun.ai/api/v1/3d_models/renderings', {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer $V2FUN_API_KEY',
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    "input_model": "models/example.glb"
  }),
});
const data = await response.json();
python
import requests

resp = requests.post(
    'https://api.v2fun.ai/api/v1/3d_models/renderings',
    headers={
        'Authorization': 'Bearer $V2FUN_API_KEY',
        'Content-Type': 'application/json',
    },
    json={
        "input_model": "models/example.glb"
    },
)
print(resp.json())
java
import java.net.URI;
import java.net.http.*;

HttpClient client = HttpClient.newHttpClient();
String body = "{\"input_model\":\"models/example.glb\"}";
HttpRequest request = HttpRequest.newBuilder()
    .uri(URI.create("https://api.v2fun.ai/api/v1/3d_models/renderings"))
    .header("Authorization", "Bearer $V2FUN_API_KEY")
    .header("Content-Type", "application/json")
    .POST(HttpRequest.BodyPublishers.ofString(body))
    .build();
HttpResponse<String> response = client.send(
    request, HttpResponse.BodyHandlers.ofString());
System.out.println(response.body());

Core Use Cases ​

Generate Render Preview ​

Render a 3D model into a high-quality preview image with standard lighting, ideal for asset library management and web display.

bash
curl -X POST 'https://api.v2fun.ai/api/v1/3d_models/renderings' \
  -H 'Authorization: Bearer $V2FUN_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{
      "input_model": "https://asset.v2fun.ai/upload/render-input-scifi-gate.glb",
      "output_type": "image"
    }'
javascript
const response = await fetch('https://api.v2fun.ai/api/v1/3d_models/renderings', {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer $V2FUN_API_KEY',
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    "input_model": "https://asset.v2fun.ai/upload/render-input-scifi-gate.glb",
    "output_type": "image"
  }),
});
const data = await response.json();
python
import requests

resp = requests.post(
    'https://api.v2fun.ai/api/v1/3d_models/renderings',
    headers={
        'Authorization': 'Bearer $V2FUN_API_KEY',
        'Content-Type': 'application/json',
    },
    json={
        "input_model": "https://asset.v2fun.ai/upload/render-input-scifi-gate.glb",
        "output_type": "image"
    },
)
print(resp.json())
java
import java.net.URI;
import java.net.http.*;

HttpClient client = HttpClient.newHttpClient();
String body = "{\"input_model\":\"https://asset.v2fun.ai/upload/render-input-scifi-gate.glb\",\"output_type\":\"image\"}";
HttpRequest request = HttpRequest.newBuilder()
    .uri(URI.create("https://api.v2fun.ai/api/v1/3d_models/renderings"))
    .header("Authorization", "Bearer $V2FUN_API_KEY")
    .header("Content-Type", "application/json")
    .POST(HttpRequest.BodyPublishers.ofString(body))
    .build();
HttpResponse<String> response = client.send(
    request, HttpResponse.BodyHandlers.ofString());
System.out.println(response.body());
Input Model
Output
Output

360° Turntable Video ​

Set output_type: "video" to let the AI automatically render a smooth full-orbit preview video around the model — no need to submit multiple frame tasks manually. Ideal for e-commerce showcases, asset reviews, or any scenario requiring dynamic visuals.

output_type: image · video

bash
curl -X POST 'https://api.v2fun.ai/api/v1/3d_models/renderings' \
  -H 'Authorization: Bearer $V2FUN_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{
      "input_model": "https://asset.v2fun.ai/upload/render-input-scifi-gate.glb",
      "output_type": "video"
    }'
javascript
const response = await fetch('https://api.v2fun.ai/api/v1/3d_models/renderings', {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer $V2FUN_API_KEY',
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    "input_model": "https://asset.v2fun.ai/upload/render-input-scifi-gate.glb",
    "output_type": "video"
  }),
});
const data = await response.json();
python
import requests

resp = requests.post(
    'https://api.v2fun.ai/api/v1/3d_models/renderings',
    headers={
        'Authorization': 'Bearer $V2FUN_API_KEY',
        'Content-Type': 'application/json',
    },
    json={
        "input_model": "https://asset.v2fun.ai/upload/render-input-scifi-gate.glb",
        "output_type": "video"
    },
)
print(resp.json())
java
import java.net.URI;
import java.net.http.*;

HttpClient client = HttpClient.newHttpClient();
String body = "{\"input_model\":\"https://asset.v2fun.ai/upload/render-input-scifi-gate.glb\",\"output_type\":\"video\"}";
HttpRequest request = HttpRequest.newBuilder()
    .uri(URI.create("https://api.v2fun.ai/api/v1/3d_models/renderings"))
    .header("Authorization", "Bearer $V2FUN_API_KEY")
    .header("Content-Type", "application/json")
    .POST(HttpRequest.BodyPublishers.ofString(body))
    .build();
HttpResponse<String> response = client.send(
    request, HttpResponse.BodyHandlers.ofString());
System.out.println(response.body());
Input Model
Output