Felo API PlatformFelo API Platform
Quay lại danh sách mô hình

HY-World 2.1 Panorama API

Tencent: HY-World2.1 Panorama tạo một ảnh toàn cảnh hình chữ nhật360 độ độ phân giải cao từ một lời nhắc văn bản duy nhất.

Tencent: HY-World2.1 Panorama là mô hình tạo ảnh chuyên biệt thuộc dòng Hunyuan World của Tencent. Mô hình nhận văn bản và tạo một ảnh toàn cảnh equirectangular360 độ độ phân giải cao trong mỗi yêu cầu, với bố cục cảnh nhất quán và liền mạch trên toàn bộ hình cầu. Lời nhắc được giới hạn ở600 ký tự, còn ngữ cảnh là4K.

Mô hình phù hợp để tạo chuyến tham quanảo, skybox, bối cảnh trò chơi và nội dung thực tế tăng cường.Ảnh toàn cảnh có thể làm nền cho việc lập kế hoạch đường đi camera hoặc mở rộng stereo thành môi trường3D có thể điều hướng, đồng thời hỗ trợ mô phỏng huấn luyện robot, lập kế hoạch đường đi và điều hướng bằng thị giác. Tài sản3D được tạo trong quy trình liên quan có thể nhập vào Unity, Unreal Engine và Blender.

Bản cập nhật HY-World2.1 hướng đến hình học sạch hơn, kết xuất sắc nét hơn và phạm vi khám phá rộng hơn. Đây là giai đoạn tạo panorama trong một quy trình lớn hơn để xây dựng thế giới3D có thể khám phá; quy trình mở rộng có thể tạo mesh, Gaussian splattings và point clouds. Hiện chưa có điểm chuẩn riêng cho HY-World2.1 Panorama.

Cập nhật:

ID MÔ HÌNH

hy-world-2.1-panorama
Đầu vào
text
Đầu ra
image

Điểm nổi bật

  • Panorama360 độ độ phân giải cao
  • Bố cục liền mạch toàn hình cầu
  • Mỗi yêu cầu một panorama
  • Lời nhắc tối đa600 ký tự
  • Hỗ trợ quy trình3D mở rộng

Nhà cung cấp

1 nhà cung cấp

So sánh giá API giữa các nhà cung cấp. Chọn một nhà cung cấp để xem toàn bộ chi phí và điều kiện.

Nhà cung cấp · Chi tiết giá
Tỷ lệ khả dụng

Điểm chuẩn

  • Tanks-and-Temples

    Điểm F1 của hệ thống HY-World2.0 liên quan.

    41.43
  • MipNeRF360

    Điểm của hệ thống HY-World2.0 liên quan.

    51.27
  • Rotation error

    Sai số tính bằng độ của WorldStereo2.0, so với0.762 độ ở phiên bản1.

    0.492
  • Translation error

    Sai số tính bằng mét của WorldStereo2.0, so với1.245 mét ở phiên bản1.

    0.968

Điểm số theo công bố của nhà cung cấp mô hình.

Bắt đầu nhanh

Gửi tác vụ ảnh, kiểm tra trạng thái rồi lưu ảnh. Ví dụ dùng curl và thư viện chuẩn Python 3.

POST https://openapi.felo.ai/api/v1/images/generations

1Thiết lập khóa API

Tạo khóa trong tài khoản Felo API Platform của bạn và đặt làm biến môi trường.

export FELO_API_KEY="YOUR_API_KEY"

2Gửi yêu cầu đầu tiên

Giá trị tùy chọn khác nhau theo mô hình và không được đặt sẵn. Hãy xác nhận trong Playground. Các trường cùng cấp với model và prompt, không bọc trong input.

curl --fail-with-body --max-time 60 "https://openapi.felo.ai/api/v1/images/generations" \
  -H "Authorization: Bearer $FELO_API_KEY" \
  -H "Content-Type: application/json" \
  -o created.json \
  -d '{
  "prompt": "A studio product photo of a ceramic coffee cup on warm linen, soft morning light",
  "model": "hy-world-2.1-panorama"
}'

3Thăm dò tác vụ

Yêu cầu trả về task_id. Kiểm tra mỗi 3 giây khi queued hoặc running; dừng khi succeeded, failed hoặc interrupted. Chờ tối đa 30 phút. Giữ created.json để tiếp tục kiểm tra cùng tác vụ mà không gửi lại.

python3 - <<'PY'
import json, os, time
from pathlib import Path
from urllib.parse import quote
from urllib.request import Request, urlopen

task = json.loads(Path("created.json").read_text())
task_id = task["task_id"]
url = "https://openapi.felo.ai/api/v1/images/generations/" + quote(task_id, safe="")
headers = {"Authorization": "Bearer " + os.environ["FELO_API_KEY"]}
deadline = time.monotonic() + 1800

while task["status"] in ("queued", "running"):
    if time.monotonic() >= deadline:
        raise TimeoutError(f"Keep task_id={task_id} to resume polling")
    time.sleep(3)
    with urlopen(Request(url, headers=headers), timeout=60) as response:
        task = json.load(response)
    if task.get("task_id") != task_id or task.get("kind") != "image":
        raise ValueError("Unexpected task response")
    print(task["status"])

if task["status"] != "succeeded":
    raise RuntimeError(task.get("error") or task["status"])
if not task.get("outputs"):
    raise ValueError("Task succeeded without image outputs")
Path("task.json").write_text(json.dumps(task))
print("Saved task.json")
PY

4Tải đầu ra

Sau khi thành công, lưu outputs từ task.json. Hỗ trợ URL HTTPS, đối tượng URL và b64_json. Tải URL có chữ ký sớm; tải ảnh không cần API key.

python3 - <<'PY'
import base64, json
from pathlib import Path
from urllib.request import urlopen

task = json.loads(Path("task.json").read_text())
if task.get("status") != "succeeded" or not task.get("outputs"):
    raise ValueError("No completed image outputs")
extensions = {"image/png": ".png", "image/jpeg": ".jpg", "image/webp": ".webp", "image/gif": ".gif", "image/avif": ".avif"}

for index, output in enumerate(task["outputs"], 1):
    item = output if isinstance(output, dict) else {}
    url = output if isinstance(output, str) else item.get("url") or item.get("unsigned_url")
    mime = item.get("media_type") or "image/png"
    if url and url.startswith("https://"):
        with urlopen(url, timeout=60) as response:
            data = response.read()
            mime = response.headers.get_content_type()
    elif url and url.startswith("data:image/") and ";base64," in url:
        header, encoded = url.split(",", 1)
        mime = header[5:].split(";", 1)[0]
        data = base64.b64decode(encoded, validate=True)
    elif item.get("b64_json"):
        data = base64.b64decode(item["b64_json"], validate=True)
    else:
        raise ValueError("Unrecognized image output")
    path = Path(f"image-{index}" + extensions.get(mime, ".bin"))
    path.write_bytes(data)
    print(path)
PY

Tham số hỗ trợ

  • n

Muốn xem tài liệu tham chiếu đầy đủ?

Tham chiếu API →

Câu hỏi thường gặp

Tìm hiểu HY-World 2.1 Panorama?

Tencent: HY-World2.1 Panorama là mô hình tạo ảnh chuyên biệt thuộc dòng Hunyuan World của Tencent. Mô hình nhận văn bản và tạo một ảnh toàn cảnh equirectangular360 độ độ phân giải cao trong mỗi yêu cầu, với bố cục cảnh nhất quán và liền mạch trên toàn bộ hình cầu. Lời nhắc được giới hạn ở600 ký tự, còn ngữ cảnh là4K. Mô hình phù hợp để tạo chuyến tham quanảo, skybox, bối cảnh trò chơi và nội dung thực tế tăng cường.Ảnh toàn cảnh có thể làm nền cho việc lập kế hoạch đường đi camera hoặc mở rộng stereo thành môi trường3D có thể điều hướng, đồng thời hỗ trợ mô phỏng huấn luyện robot, lập kế hoạch đường đi và điều hướng bằng thị giác. Tài sản3D được tạo trong quy trình liên quan có thể nhập vào Unity, Unreal Engine và Blender. Bản cập nhật HY-World2.1 hướng đến hình học sạch hơn, kết xuất sắc nét hơn và phạm vi khám phá rộng hơn. Đây là giai đoạn tạo panorama trong một quy trình lớn hơn để xây dựng thế giới3D có thể khám phá; quy trình mở rộng có thể tạo mesh, Gaussian splattings và point clouds. Hiện chưa có điểm chuẩn riêng cho HY-World2.1 Panorama.

Cách tính phí sử dụng?

Hóa đơn của bạn phụ thuộc vào nhà cung cấp bạn dùng, giá của họ và mức sử dụng của bạn. Đầu vào dài hơn hoặc các điều kiện khác có thể có giá khác. Tính phí theo chi phí tạo thực tế. Xem hóa đơn để biết số tiền cuối cùng.

Mô hình hỗ trợ những dạng đầu vào và đầu ra nào?

Mô hình nhận đầu vào văn bản và tạo đầu ra hình ảnh. Mỗi yêu cầu tạo một panorama duy nhất.

Giới hạn lời nhắc và ngữ cảnh là bao nhiêu?

Lời nhắc được giới hạn ở600 ký tự. Ngữ cảnh của mô hình là4K.

Mô hình phù hợp với những tác vụ nào?

Mô hình phù hợp để tạo chuyến tham quanảo, skybox, bối cảnh trò chơi, nội dung thực tế tăng cường và mô phỏng huấn luyện robot. Panorama cũng có thể làm nền cho lập kế hoạch đường đi camera và mở rộng stereo thành môi trường3D có thể điều hướng.

Mô hình khác gì so với các mô hình cùng dòng?

HY-World2.1 Panorama tập trung vào việc tạo một panorama360 độ từ lời nhắc văn bản. Đây là giai đoạn panorama trong quy trình Hunyuan World lớn hơn dành cho các tài sản3D có thể khám phá và chỉnh sửa.

Mô hình liên quan