Tư thế chữ T tự động
Hoạt độngBiến ảnh nhân vật thành tư thế chữ T chính diện gọn gàng, tư thế mà công cụ 3D cần. Ảnh đã ở tư thế chữ T chỉ tốn phí kiểm tra.
Tư thế chữ T tự động
Đầu vào
imageLink https công khai tới ảnh nhân vật.
knight-input-990bde6e.webp
prompt_hintTùy chọn: vài từ về nhân vật để giữ nhân vật như cũ.Mỗi lần chạy trả phí kiểm tra ($0.01341). Phí chỉnh sửa ($0.03941) chỉ cộng thêm khi ảnh chưa ở tư thế chữ T.


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.
Chạy cả ba bước trong một lần gọi:Nhân vật 3D
Gọi Tư thế chữ T tự động 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:/ / api.opennan.com/ v1/ 3d/ tpose- POST
/Từ ảnh hoặc prompt thành nhân vật đã rig.v1/ 3d/ characters - 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/tpose \ -H "Authorization: Bearer $OPENNAN_KEY" \ -H "Content-Type: application/json" \ -d '{"image":"https://example.com/character.png"}' # 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:/ / api.opennan.com/ v1/ mcpDù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_tpose_image
- Tham số mẫu
{ "image": "https://example.com/character.png" }
Tư thế chữ T tự động: câu hỏi
Tư thế chữ T tự động 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/tpose 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_tpose_image, 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.