Nhân vật 3D
Hoạt độngGửi ảnh hoặc mô tả nhân vật. Nhận mô hình 3D đã rig dạng GLB và FBX, kèm clip đi và chạy. Ảnh không ở tư thế chữ T sẽ được vẽ lại ở tư thế đó trước.
Nhân vật 3D
Đầu vào
imageLink https công khai tới ảnh.
knight-tpose-7beb62e2.png
qualityTiêu chuẩn hoặc chi tiết cao.engineEngine 3D thực hiện (chỉ gửi khi có nhiều hơn một).animationsClip hoạt ảnh làm cho mô hình đã rig.Không tính thêm phíĐể có nhân vật đẹp nhất: một người, chính diện, miệng khép mặt trung tính, nền trơn, tay không cầm gì.
3D tiêu chuẩn3D tiêu chuẩn
Đang tải hoạt ảnh…- 1. Kiểm tra tư thế chữ TKhông có trong kết quả này.
- 2. Mô hình 3DĐã tạo mô hình có texture.
- 3. RigĐã rig, kèm 2 clip.
Từng bước riêng lẻ
Pipeline ở trên nối các công cụ này lại. Gọi riêng từng cái cũng được: mỗi công cụ có endpoint, giá và trang riêng.
Cách pipeline 3D hoạt động
Đúng những bước chúng tôi dùng để làm nhân vật cho game của chính mình.
- 01Kiểm tra tư thế chữ TXem nhanh ảnh của bạn. Nếu chưa phải tư thế chữ T chính diện chuẩn, miệng khép, mặt trung tính, nền trơn, ảnh sẽ được vẽ lại như vậy với cùng nhân vật. Tay dang ngang giúp bàn tay gọn gàng.
- 02Mô hình 3DLưới có texture, sẵn sàng cho game, làm từ ảnh tư thế chữ T, dùng vật liệu PBR và đã bỏ ánh sáng nướng sẵn. Nhân vật và đạo cụ có giới hạn tam giác riêng.
- 03RigBộ xương khớp với nhân vật để nhân vật cử động được, kèm clip đi và chạy nếu bạn muốn. Bạn nhận FBX cho game engine và GLB cho web.
Gọi Nhân vật 3D từ mã của bạn
Mỗi công cụ 3D là một endpoint riêng. Mỗi lần gọi trả về một tác vụ: kiểm tra đến khi xong. Lần chạy thất bại không bị tính phí.
https:/- POST
/Ảnh nhân vật bất kỳ thành tư thế chữ T chính diện.v1/ 3d/ tpose - POST
/Từ ảnh hoặc prompt thành mô hình có texture.v1/ 3d/ models - POST
/Mô hình hình người thành FBX và GLB đã rig.v1/ 3d/ rig - GET
/Tiến độ và tệp đầu ra.v1/ tasks/ {id} - GET
/Engine 3D và mức chất lượng, kèm giáv1/ models? category= 3d
Lấy khóa API
Tạo khóa trong bảng điều khiển. Khóa dùng chung số dư với phần dùng thử.
Tạo khóaGửi yêu cầu đầu tiên
Chính yêu cầu mà phần dùng thử gửi. Đặt OPENNAN_KEY là khóa của bạn.
curl https://api.opennan.com/v1/3d/characters \ -H "Authorization: Bearer $OPENNAN_KEY" \ -H "Content-Type: application/json" \ -d '{"prompt":"a knight in silver armour with a blue cape","quality":"standard","animations":true,"engine":"opennan-3d-studio"}' # Then poll until "status" is "succeeded" or "failed": curl https://api.opennan.com/v1/tasks/<task id> -H "Authorization: Bearer $OPENNAN_KEY"Kiểm tra tác vụ
Lệnh gọi trả về ngay một id tác vụ. Hỏi tác vụ đó cho đến khi xong:
GEThttps:// api.opennan.com/ v1/ tasks/ {id} - queued
- Đang chờ máy xử lý
- running
- Đang tạo
- succeeded
- Xong: outputs[].url chứa các tệp
- failed
- Thất bại: không tính phí
Lỗi và cách khắc phục
401Thiếu khóa hoặc sai khóa
Gửi header Authorization: Bearer với một khóa từ bảng điều khiển.
402Số dư không đủ
Nạp tiền trong mục Thanh toán, rồi gửi lại đúng lệnh gọi đó.
400Có giá trị không được chấp nhận
Đọc error.message: nó nêu tên trường. Dùng một giá trị trong bảng tham số.
429Quá nhiều yêu cầu
Chờ vài giây rồi thử lại, chờ lâu hơn sau mỗi lần gặp 429.
Thêm Opennan vào ứng dụng AI của bạn
Cài một lần, AI của bạn dùng được mọi công cụ của Opennan: video, hình ảnh, chat, giọng nói, âm nhạc, hiệu ứng âm thanh, 3D, phụ đề và lồng tiếng. Chọn ứng dụng và làm theo các bước.
https:/Dùng được trong Codex CLI, ứng dụng Codex và tiện ích Codex cho IDE: chúng dùng chung ~/.codex/config.toml. Nếu ứng dụng hoặc IDE không thấy OPENNAN_KEY, hãy dùng cách config.toml có sẵn khóa. Codex hỏi trước mỗi lần gọi công cụ: chấp thuận để tiếp tục.
Lấy khóa API
Tạo khóa trong bảng điều khiển. Khóa bắt đầu bằng sk- và dùng chung số dư với trang web.
Tạo khóaLưu khóa thành OPENNAN_KEY
# macOS / Linux (zsh shown; bash: ~/.bashrc) echo 'export OPENNAN_KEY="sk-..."' >> ~/.zshrc source ~/.zshrc # Windows (PowerShell), then open a new terminal setx OPENNAN_KEY "sk-..."Cài plugin Opennan: gồm máy chủ và một skill dạy AI chọn mô hình, xác nhận giá và chờ kết quả
codex plugin marketplace add Opennan/opennan-ai-plugin codex plugin add opennan@opennanHoặc chỉ thêm máy chủ
codex mcp add opennan --url https://api.opennan.com/v1/mcp --bearer-token-env-var OPENNAN_KEYHoặc thêm phần này vào ~/.codex/config.toml
[mcp_servers.opennan] url = "https://api.opennan.com/v1/mcp" http_headers = { Authorization = "Bearer sk-..." }Kiểm tra opennan có trong danh sách
codex mcp listKhởi động lại Codex, rồi yêu cầu bất cứ thứ gì
“Làm video 5 giây cảnh mưa trên con phố đèn neon, một bài hát đi kèm và một ảnh poster.”
Thay sk-... bằng khóa của bạn và giữ bí mật: ai có khóa đều tiêu được số dư của bạn. Ứng dụng có thể liệt kê công cụ khi chưa có khóa; muốn tạo gì thì cần khóa.
Dùng từ tác tử AI
Thêm máy chủ MCP của Opennan vào tác tử và gọi công cụ này.
- Công cụ
- generate_3d_character
- Tham số mẫu
{ "prompt": "a knight in silver armour with a blue cape", "quality": "standard", "animations": true, "engine": "opennan-3d-studio" }
Nhân vật 3D: câu hỏi
Nhân vật 3D giá bao nhiêu?
Bạn trả theo mỗi lần chạy, theo giá hiển thị trước khi bắt đầu.
Gọi từ mã của tôi như thế nào?
Gửi POST https://api.opennan.com/v1/3d/characters kèm khóa API của bạn. Phản hồi là một id tác vụ: hỏi https://api.opennan.com/v1/tasks/{id} cho đến khi tác vụ thành công hoặc thất bại.
Tác tử AI của tôi có dùng được không?
Có. Thêm máy chủ MCP https://api.opennan.com/v1/mcp và gọi công cụ generate_3d_character, hoặc chỉ tác tử đến https://api.opennan.com/llms.txt.
Nếu một lần chạy thất bại thì sao?
Lần chạy thất bại không bị tính phí. Bạn chỉ trả cho kết quả.
Vì sao ảnh cần ở tư thế chữ T?
Tay dang thẳng giúp bàn tay tách khỏi thân, nên mô hình có bàn tay gọn và rig gập đúng khớp. Tay buông xuống hoặc tư thế chữ A thường khiến bàn tay dính vào quần áo, còn nụ cười bị vẽ vào texture. Vì vậy ảnh không ở tư thế chữ T sẽ được vẽ lại trước, vẫn là nhân vật đó.
Tôi nhận được những tệp nào?
GLB cho web, game engine và ứng dụng 3D, FBX cho Roblox Studio, Unity, Unreal và Blender, cùng một ảnh thu nhỏ. Lần chạy có rig thêm clip đi và chạy.