Docs

Running a model

TencentIn the appsImage to 3D

Tencent Hunyuan3D Omni

One image in. A textured, rigged mesh out.

POSTauray-ai/hunyuan-3d/image-to-3d
openapi.jsonllms.txt

One of the models behind Auray's apps, under the auray-ai/ namespace.

Its request shape is published below. Whether it runs right now is GET /v1/catalogue's word, with no key needed: its addresses say connected for an address that runs, and a submit to any other is refused before anything is charged — described answers 501 model_not_connected, paused 503 model_disabled.

Category image-to-3d · Scope 3d:write (or threed:write on an older key) · Price By tier — a mesh, textured, rigged, and the guided pair each carry their own price in credits, which GET /v1/plans serves in force as price_keys (threed.<tier>); the submit quotes the one it charges.

#Input

FieldTypeRequiredDefaultDescription
image_pathstringyes—The photograph to build from: the path that POST /v1/uploads with address: "auray-ai/hunyuan-3d/image-to-3d" answered, sent once its bytes have been PUT. A path from POST /v1/uploads; this platform never fetches a URL you give it.
tierstringyes—Required, with no default — and the refusal body carries no list of valid values, unlike video. One of "geometry", "textured", "rigged", "controlled-object", "controlled-character".
out_formatstringno"glb"fbx only means anything on a tier that produces a skeleton. One of "glb", "fbx".
control_typestringno—Coupled to the tier rather than free — controlled-object takes bbox, controlled-character takes pose. One of "bbox", "pose".
control_datanumber[] or number[][]no—A JSON list whose shape follows control_type, never a string. For bbox (controlled-object): three numbers [width, height, depth] — x across, y up, z front to back — each above 0 and at most 1; they are an aspect ratio, scaled so the longest is 1.0 before the model reads them. For pose (controlled-character): one row of six numbers per bone, [x1, y1, z1, x2, y2, z2] from the bone's start to its end, in the same axes, the figure standing about 1.8 units tall with its feet near y = -1, at most 512 rows. The model reads these coordinates as they are and was trained on Tencent's 51-bone A-pose — this field's second worked value, in openapi.json's examples and on the reference page, and what the desktop sends — so start from it and move the bones: a skeleton far from it does not fail, it steers the mesh somewhere the model never learned.
num_inference_stepsintegerno50More steps, more detail, a longer run. Outside 1–100 is ignored rather than refused. Documented range: 1 to 100.
seedintegerno—Reuse one to get the same mesh back. Outside the range it is refused with 422 seed_out_of_range, before any charge. Documented range: 0 to 2,147,483,647.
source_namestringno—A label carried through to the stored job, for your own bookkeeping.
idempotency_keystringno—Your own name for this request. Send the same one twice and the second call is answered with the first request rather than charged again. Idempotency-Key: as a header is accepted as an alias — that is the spelling a retrying proxy replays, and the one to use when running a model on auray.run, where a request that outlives its connection is answered 504 and recovered by replay. Omit it and the platform mints one. 1 to 64 characters.

#control_data values

[0.6,1,0.45]
[[-0.000444,0.291595,0.060764,-0.000444,0.396635,0.060946],[-0.000444,0.396635,0.060946,-0.000444,0.585997,0.003098],[-0.000444,0.585997,0.003098,-0.000444,0.650996,0.0055],[-0.000444,0.650996,0.0055,-0.000444,0.825725,0.006844],[-0.042764,0.741534,0.045801,-0.05044,0.741534,0.082945],[0.041877,0.741534,0.045801,0.049552,0.741534,0.082944],[-0.021642,0.580726,0.014279,-0.119861,0.549528,0.013144],[-0.119861,0.549527,0.013144,-0.314726,0.387112,0.010027],[-0.314893,0.387495,0.009296,-0.501419,0.232088,0.01016],[-0.501353,0.231999,0.010353,-0.535316,0.201472,0.010129],[-0.508689,0.21865,0.039165,-0.522616,0.193301,0.053323],[-0.522616,0.193301,0.053323,-0.533293,0.175084,0.057557],[-0.533294,0.175084,0.057557,-0.544284,0.156764,0.062264],[-0.56041,0.179823,0.036836,-0.581018,0.161387,0.036989],[-0.581018,0.161387,0.036989,-0.599051,0.145654,0.036997],[-0.599051,0.145654,0.036997,-0.621468,0.126112,0.037087],[-0.562667,0.17864,0.018401,-0.583446,0.159637,0.018674],[-0.583445,0.159637,0.018674,-0.602133,0.142816,0.018623],[-0.602133,0.142816,0.018623,-0.625967,0.122118,0.018822],[-0.560707,0.179455,0.000673,-0.580487,0.161298,0.000679],[-0.580487,0.161297,0.000679,-0.59794,0.145378,0.000766],[-0.59794,0.145378,0.000766,-0.620124,0.125446,0.001124],[-0.555785,0.182031,-0.017658,-0.573838,0.165143,-0.017335],[-0.573838,0.165142,-0.017335,-0.584281,0.155469,-0.017116],[-0.584281,0.155469,-0.017116,-0.600597,0.141304,-0.016992],[0.020755,0.580726,0.01428,0.118974,0.549528,0.013144],[0.118974,0.549528,0.013145,0.313839,0.387113,0.010028],[0.314893,0.389919,0.009529,0.501419,0.234513,0.010393],[0.501353,0.234424,0.010505,0.535317,0.203898,0.010281],[0.50869,0.221075,0.039318,0.522617,0.195726,0.053476],[0.522617,0.195726,0.053476,0.533294,0.17751,0.05771],[0.533295,0.177509,0.05771,0.544285,0.159189,0.062417],[0.560409,0.18225,0.036991,0.581018,0.163813,0.037145],[0.581018,0.163813,0.037145,0.599051,0.148081,0.037153],[0.599051,0.148081,0.037153,0.621468,0.128538,0.037243],[0.562666,0.181066,0.018556,0.583445,0.162064,0.01883],[0.583446,0.162064,0.01883,0.602133,0.145242,0.018779],[0.602133,0.145242,0.018779,0.625967,0.124545,0.018977],[0.560707,0.181882,0.000829,0.580486,0.163724,0.000835],[0.580486,0.163724,0.000835,0.597939,0.147804,0.000922],[0.597939,0.147804,0.000922,0.620123,0.127872,0.00128],[0.555783,0.184458,-0.017502,0.573837,0.167569,-0.017179],[0.573837,0.167569,-0.017179,0.58428,0.157896,-0.01696],[0.58428,0.157896,-0.01696,0.600596,0.143731,-0.016836],[-0.000444,0.28643,0.061981,-0.000444,0.171162,0.061163],[-0.081349,0.123999,0.041635,-0.080669,-0.360865,0.032717],[-0.080669,-0.360865,0.032717,-0.08361,-0.868134,-0.019135],[-0.08361,-0.868134,-0.019135,-0.08361,-0.994443,0.157177],[0.080462,0.123999,0.041635,0.079782,-0.360865,0.032715],[0.079782,-0.360865,0.032715,0.082723,-0.868134,-0.019135],[0.082723,-0.868134,-0.019135,0.082723,-0.994443,0.157177]]

#Example

curl -X POST https://queue.auray.run/auray-ai/hunyuan-3d/image-to-3d \
  -H "Authorization: Bearer $AURAY_API_KEY" \
  -H "content-type: application/json" \
  -d '{
  "image_path": "your-user-id/your-idempotency-key.png",
  "tier": "geometry"
}'

The same body on https://auray.run runs synchronously and answers the result — unless it usually takes longer than a run may hold its connection, which is refused 400 model_not_synchronous before anything is charged. Options — ?webhook=, ?wait=, priority and timeout headers — are on Submit a request.

#Machine contracts

  • openapi.json — this page as an OpenAPI 3.1 document, public.
  • llms.txt — the same, written for an agent.

Start typing to search every page of the documentation.

Up arrow Down arrow to moveEnter to openEscape to close