feat: integrate Tripo 3D provider

This commit is contained in:
wlx committed 2026-08-25 17:04:37 +08:00
1 parent ec51e8c802
commit 18a55346c6
9 files changed
+306 -6

No files matched your search

+4 -4
View File
@@ -114,7 +114,7 @@ export class MemoryCatalogRepository implements CatalogRepository {
code: 'vast',
name: 'VAST / Tripo',
protocol: 'http',
description: '预留 3D 生成供应商适配位,D4 先登记目录。',
description: 'Tripo v3 文生 3D 供应商适配器;未配置服务端密钥时自动使用 Mock。',
status: 'active',
createdAt: now,
updatedAt: now,
@@ -139,11 +139,11 @@ export class MemoryCatalogRepository implements CatalogRepository {
this.models.set('model-mock-3d', {
id: 'model-mock-3d',
providerId: vastProvider.id,
publicName: 'VAST 3D Generator (Mock)',
upstreamModel: 'tripo-mock-3d-v1',
publicName: 'Tripo 3D Generator',
upstreamModel: 'v3.1-20260211',
type: '3d',
mode: 'async',
description: '异步 3D 生成模型,预留任务创建、轮询和回调字段。',
description: 'Tripo v3.1 异步 3D 生成模型,支持任务创建、进度轮询和 GLB 结果。',
inputTypes: ['text', 'image'],
outputTypes: ['model', 'thumbnail'],
capabilities: { taskPolling: true, webhook: true, formats: ['glb', 'obj', 'fbx'] },
+174
View File
@@ -0,0 +1,174 @@
export type TripoTaskStatus = 'queued' | 'running' | 'success' | 'failed' | 'cancelled'
export interface TripoTaskOutput {
model_url?: string
rendered_image_url?: string
[key: string]: unknown
}
export interface TripoTask {
task_id: string
type: string
status: TripoTaskStatus
progress: number
output?: TripoTaskOutput
error_code?: number
error_message?: string
credits_consumed?: number
created_at?: string
completed_at?: string
}
export interface TripoApiResponse<T> {
code: number
message?: string
data?: T
}
export interface TripoTextToModelInput {
prompt: string
model?: string
negative_prompt?: string
model_seed?: number
image_seed?: number
face_limit?: number
texture?: boolean
pbr?: boolean
texture_quality?: 'standard' | 'detailed' | 'extreme'
geometry_quality?: 'standard' | 'detailed'
auto_size?: boolean
quad?: boolean
smart_low_poly?: boolean
generate_parts?: boolean
compress?: 'geometry'
export_uv?: boolean
}
export interface MoyiTaskView {
id: string
provider: 'tripo'
status: 'queued' | 'running' | 'succeeded' | 'failed' | 'cancelled'
progress: number
model?: string
output?: { modelUrl?: string; previewUrl?: string }
creditsConsumed?: number
error?: { code?: number; message?: string }
createdAt?: string
completedAt?: string
}
export interface TripoProviderOptions {
apiKey: string
baseUrl?: string
timeoutMs?: number
fetcher?: typeof fetch
}
export class TripoProviderError extends Error {
constructor(
message: string,
readonly statusCode?: number,
readonly providerCode?: number,
) {
super(message)
}
}
export class TripoProvider {
private readonly baseUrl: string
private readonly timeoutMs: number
private readonly fetcher: typeof fetch
constructor(private readonly options: TripoProviderOptions) {
if (!options.apiKey.trim()) throw new TripoProviderError('TRIPO_API_KEY 未配置')
this.baseUrl = (options.baseUrl || 'https://openapi.tripo3d.com/v3').replace(/\/$/, '')
this.timeoutMs = options.timeoutMs ?? 30_000
this.fetcher = options.fetcher || fetch
}
async createTextToModel(input: TripoTextToModelInput) {
const prompt = input.prompt.trim()
if (!prompt) throw new TripoProviderError('Tripo prompt 不能为空')
if (prompt.length > 1024) throw new TripoProviderError('Tripo prompt 不能超过 1024 个字符')
const response = await this.request<TripoTask>('/generation/text-to-model', {
method: 'POST',
body: JSON.stringify({
model: input.model || 'v3.1-20260211',
texture: true,
pbr: true,
...input,
prompt,
}),
})
if (!response.data?.task_id) throw new TripoProviderError(response.message || 'Tripo 未返回任务 ID', undefined, response.code)
return response.data.task_id
}
async getTask(taskId: string): Promise<MoyiTaskView> {
if (!/^[a-zA-Z0-9][a-zA-Z0-9_-]{7,127}$/.test(taskId)) throw new TripoProviderError('Tripo task_id 格式无效')
const response = await this.request<TripoTask>(`/tasks/${encodeURIComponent(taskId)}`)
if (!response.data) throw new TripoProviderError(response.message || 'Tripo 未返回任务数据', undefined, response.code)
return mapTripoTask(response.data)
}
async waitForTask(taskId: string, options: { intervalMs?: number; timeoutMs?: number } = {}) {
const intervalMs = options.intervalMs ?? 3_000
const timeoutMs = options.timeoutMs ?? 10 * 60_000
const deadline = Date.now() + timeoutMs
while (Date.now() <= deadline) {
const task = await this.getTask(taskId)
if (task.status === 'succeeded' || task.status === 'failed' || task.status === 'cancelled') return task
await new Promise((resolve) => setTimeout(resolve, intervalMs))
}
throw new TripoProviderError(`Tripo 任务轮询超时:${taskId}`)
}
private async request<T>(path: string, init: { method?: string; body?: string } = {}): Promise<TripoApiResponse<T>> {
const controller = new AbortController()
const timer = setTimeout(() => controller.abort(), this.timeoutMs)
try {
const response = await this.fetcher(`${this.baseUrl}${path}`, {
method: init.method || 'GET',
headers: {
Accept: 'application/json',
Authorization: `Bearer ${this.options.apiKey}`,
...(init.body ? { 'Content-Type': 'application/json' } : {}),
},
...(init.body ? { body: init.body } : {}),
signal: controller.signal,
})
const payload = await response.json().catch(() => ({})) as TripoApiResponse<T>
if (!response.ok || payload.code !== 0) {
throw new TripoProviderError(payload.message || `Tripo 请求失败(HTTP ${response.status})`, response.status, payload.code)
}
return payload
} catch (error) {
if (error instanceof TripoProviderError) throw error
if (error instanceof Error && error.name === 'AbortError') throw new TripoProviderError('Tripo 请求超时')
throw new TripoProviderError(error instanceof Error ? error.message : 'Tripo 请求失败')
} finally {
clearTimeout(timer)
}
}
}
export function mapTripoTask(task: TripoTask): MoyiTaskView {
const status = task.status === 'success' ? 'succeeded' : task.status
return {
id: task.task_id,
provider: 'tripo',
status,
progress: Math.max(0, Math.min(100, Number(task.progress) || 0)),
...(task.output ? { output: {
...(task.output.model_url ? { modelUrl: task.output.model_url } : {}),
...(task.output.rendered_image_url ? { previewUrl: task.output.rendered_image_url } : {}),
} } : {}),
...(task.credits_consumed !== undefined ? { creditsConsumed: task.credits_consumed } : {}),
...(task.error_code || task.error_message ? { error: {
...(task.error_code !== undefined ? { code: task.error_code } : {}),
...(task.error_message ? { message: task.error_message } : {}),
} } : {}),
...(task.created_at ? { createdAt: task.created_at } : {}),
...(task.completed_at ? { completedAt: task.completed_at } : {}),
}
}
+48 -1
View File
@@ -3,6 +3,7 @@ import { createServer, type IncomingMessage, type ServerResponse } from 'node:ht
import { parse as parseUrl } from 'node:url'
import { AuthError, AuthService, MemoryAuthRepository, type AuthRepository } from './auth.js'
import { CatalogService, MemoryCatalogRepository, type CallMode, type ModelType, type ProviderProtocol } from './catalog.js'
import { TripoProvider, TripoProviderError } from './providers/tripo.js'
const config = {
host: process.env.CONTROL_PLANE_HOST || '127.0.0.1',
@@ -12,6 +13,8 @@ const config = {
passwordPepper: process.env.AUTH_PASSWORD_PEPPER || 'development-only-pepper',
databaseUrl: process.env.DATABASE_URL,
nodeEnv: process.env.NODE_ENV || 'development',
tripoApiKey: process.env.TRIPO_API_KEY,
tripoBaseUrl: process.env.TRIPO_BASE_URL,
}
let repository: AuthRepository = new MemoryAuthRepository()
@@ -34,6 +37,11 @@ type MockTask = {
result?: { format: string; url: string }
}
const mockTasks = new Map<string, MockTask>()
const tripo = config.tripoApiKey ? new TripoProvider({
apiKey: config.tripoApiKey,
...(config.tripoBaseUrl ? { baseUrl: config.tripoBaseUrl } : {}),
}) : undefined
const tripoTaskOwners = new Map<string, { userId: string; model: string }>()
if (config.nodeEnv === 'production' && (!process.env.AUTH_PASSWORD_PEPPER || process.env.AUTH_PASSWORD_PEPPER.length < 32)) {
throw new Error('AUTH_PASSWORD_PEPPER must contain at least 32 characters in production')
@@ -57,7 +65,7 @@ const server = createServer(async (request, response) => {
response.setHeader('Vary', 'Origin')
}
if (request.method === 'OPTIONS') {
response.setHeader('Access-Control-Allow-Headers', 'Content-Type')
response.setHeader('Access-Control-Allow-Headers', 'Content-Type, Authorization')
response.setHeader('Access-Control-Allow-Methods', 'GET,POST,OPTIONS')
response.writeHead(204)
response.end()
@@ -74,6 +82,7 @@ const server = createServer(async (request, response) => {
server.listen(config.port, config.host, () => {
console.log(`MOYI Control Plane listening on http://${config.host}:${config.port}`)
console.log(config.databaseUrl ? 'Persistence: PostgreSQL' : 'Persistence: in-memory development store')
console.log(tripo ? 'Tripo 3D Provider: enabled' : 'Tripo 3D Provider: mock mode')
})
async function route(request: IncomingMessage, response: ServerResponse) {
@@ -128,6 +137,23 @@ async function route(request: IncomingMessage, response: ServerResponse) {
const model = await catalogModel(modelId)
if (model.type !== '3d' || model.mode !== 'async') throw new AuthError('NOT_ASYNC_3D_MODEL', '该模型不是异步 3D 模型', 400)
if (!catalog.canInvoke(keyRecord, model.id)) throw new AuthError('MODEL_FORBIDDEN', '当前 Key 无权调用该模型', 403)
if (tripo) {
const prompt = stringValue(body.prompt).trim()
if (!prompt) throw new AuthError('PROMPT_REQUIRED', '3D 生成提示词不能为空')
const taskId = await tripo.createTextToModel({
prompt,
model: stringValue(body.providerModel) || 'v3.1-20260211',
...(body.negativePrompt ? { negative_prompt: stringValue(body.negativePrompt) } : {}),
...(body.faceLimit !== undefined ? { face_limit: numberValue(body.faceLimit, 'faceLimit') } : {}),
...(body.texture !== undefined ? { texture: booleanValue(body.texture, 'texture') } : {}),
...(body.pbr !== undefined ? { pbr: booleanValue(body.pbr, 'pbr') } : {}),
...(body.smartLowPoly !== undefined ? { smart_low_poly: booleanValue(body.smartLowPoly, 'smartLowPoly') } : {}),
})
tripoTaskOwners.set(taskId, { userId: keyRecord.userId, model: model.id })
const task = await tripo.getTask(taskId)
send(response, 202, { task: { ...task, model: model.id } })
return
}
const now = new Date().toISOString()
const task: MockTask = { id: `task_${randomToken(14)}`, userId: keyRecord.userId, model: model.id, status: 'queued', createdAt: now, updatedAt: now }
mockTasks.set(task.id, task)
@@ -145,6 +171,12 @@ async function route(request: IncomingMessage, response: ServerResponse) {
const taskId = taskMatch?.[1]
if (method === 'GET' && taskId) {
const keyRecord = await authenticatePlatformKey(request)
const tripoOwner = tripoTaskOwners.get(taskId)
if (tripo && tripoOwner) {
if (tripoOwner.userId !== keyRecord.userId) throw new AuthError('TASK_NOT_FOUND', '任务不存在', 404)
send(response, 200, { task: { ...await tripo.getTask(taskId), model: tripoOwner.model } })
return
}
const task = mockTasks.get(taskId)
if (!task || task.userId !== keyRecord.userId) throw new AuthError('TASK_NOT_FOUND', '任务不存在', 404)
send(response, 200, { task: publicTask(task) })
@@ -352,6 +384,16 @@ function stringValue(value: unknown) {
return typeof value === 'string' ? value : ''
}
function numberValue(value: unknown, field: string) {
if (typeof value !== 'number' || !Number.isFinite(value)) throw new AuthError('INVALID_NUMBER', `${field} 必须是有效数字`)
return value
}
function booleanValue(value: unknown, field: string) {
if (typeof value !== 'boolean') throw new AuthError('INVALID_BOOLEAN', `${field} 必须是布尔值`)
return value
}
async function authenticatePlatformKey(request: IncomingMessage) {
const authorization = request.headers.authorization || ''
const match = authorization.match(/^Bearer\s+(.+)$/i)
@@ -450,6 +492,11 @@ function handleError(response: ServerResponse, error: unknown) {
send(response, error.statusCode, { error: { code: error.code, message: error.message } })
return
}
if (error instanceof TripoProviderError) {
console.error(`Tripo provider error: ${error.message}`)
send(response, 502, { error: { code: 'TRIPO_PROVIDER_ERROR', message: '3D 模型供应商请求失败,请稍后重试' } })
return
}
console.error(error)
send(response, 500, { error: { code: 'INTERNAL_ERROR', message: '服务暂时不可用' } })
}