Skip to main content

Julian NXT API

Version:
v1.0.0

Upload

Get AWS S3 Upload URL

Get a pre-signed URL to upload images/models for further Julian processing.

POST
https://cloud.unlimited3d.com/api/thirdParty/generate-model/getAWSS3url

Headers Parameters

NameTypeRequiredDescription
secret-keystringYesYour secret key
public-keystringYesYour public key

Body Parameters

NameTypeRequiredDescription
extensionstringYesExtension of the file to upload (must end with .jpeg, .jpg, .png, .glb),

Upload to the AWS S3 signed URL

This API call is directly to the AWS S3 dedicated to your account under Threedium AWS S3. You do not need any credentials because the url is already signed for you by Threedium. More info: https://docs.aws.amazon.com/AmazonS3/latest/userguide/PresignedUrlUploadObject.html https://docs.aws.amazon.com/AmazonS3/latest/userguide/upload-objects.html



Job

Job Status Info

Returns info status of the job.

GET
https://cloud.unlimited3d.com/api/thirdParty/jobs/{id}/info

Headers Parameters

NameTypeRequiredDescription
secret-keystringYesYour secret key
public-keystringYesYour public key

URL Parameters

NameTypeRequiredDescription
idintegerYesID of the job.

Response Examples

{
"code": "000",
"errors": [],
"message": "ok",
"time": 1771421776,
"res": {
"id": xxxxx,
"type": "GenerateModel",
"status": "in_progress",
"result": {
"generate_model_job_id": xxxx
},
"errors": [],
"warnings": []
},
"status": 200
}



Generation

Generate Image

Generate an image using AI models.

POST
https://cloud.unlimited3d.com/api/thirdParty/generate-model/generate-image

Headers Parameters

NameTypeRequiredDescription
secret-keystringYesYour secret key
public-keystringYesYour public key

Body Parameters

NameTypeRequiredDescription
model_versionstringYesModel version. Options: flux.1_kontext_pro, flux.1_dev, gpt_4o, gemini_2.5_flash_image_preview
promptstringYesText description of the image to generate (max 1024 characters)
filenamestringNoOptional reference image filename (must end with .jpeg, .jpg, or .png)

Text to Model

Generate a 3D model from text description.

POST
https://cloud.unlimited3d.com/api/thirdParty/generate-model/text-to-model

Headers Parameters

NameTypeRequiredDescription
secret-keystringYesYour secret key
public-keystringYesYour public key

Body Parameters

NameTypeRequiredDescription
model_versionstringYesModel version. Options: Julian-6.0-NXT, Julian-5.0-NXT, Julian-4.2-NXT, Julian-1.2-NXT
promptstringYesText description of the model to generate (max 1024 characters)
negative_promptstringNoText describing what to avoid (max 255 characters)
texturebooleanNoWhether to generate texture. Default: true
pbrbooleanNoWhether to generate PBR materials. If this option is set to true, texture will be ignored and used as true. Default: true
texture_qualitystringNoTexture quality. Options: detailed, standard. Default: standard
geometry_qualitystringNoGeometry quality. Options: detailed, standard. Default: standard
face_limitintegerNoMaximum number of faces. If this value is not set, the face limit will be adaptively determined. If smart_low_poly is true, it should be 1k ~ 20k.
smart_low_polybooleanNoEnable smart low poly optimization. Default: false
generate_partsbooleanNoGenerate separate parts. *generate_parts* is not compatible with *texture=true* and *pbr=true*, set both to false to enable generating in parts. Default: false
auto_sizebooleanNoAutomatically determine model size. Default: false

Parameters and Model Versions - 3D GENERATION

The options below are only valid for model_version>=Julian-4.2-NXT :

  • face_limit
  • texture
  • pbr
  • texture_alignment
  • texture_quality
  • auto_size
  • smart_low_poly
  • generate_parts

The options below are only valid for model_version>=Julian-5.0-NXT

  • geometry_quality

Image to Model

Generate a 3D model from a single image.

POST
https://cloud.unlimited3d.com/api/thirdParty/generate-model/image-to-model

Headers Parameters

NameTypeRequiredDescription
secret-keystringYesYour secret key
public-keystringYesYour public key

Body Parameters

NameTypeRequiredDescription
model_versionstringYesModel version. Options: Julian-6.0-NXT, Julian-5.0-NXT, Julian-4.2-NXT, Julian-1.2-NXT
filenamestringYesName of the uploaded image file (must end with .jpeg, .jpg, or .png)
texturebooleanNoWhether to generate texture. Default: true
pbrbooleanNoWhether to generate PBR materials. If this option is set to true, texture will be ignored and used as true. Default: true
texture_qualitystringNoTexture quality. Options: detailed, standard. Default: standard
geometry_qualitystringNoGeometry quality. Options: detailed, standard. Default: standard
face_limitintegerNoMaximum number of faces. If this value is not set, the face limit will be adaptively determined. If smart_low_poly is true, it should be 1k ~ 20k.
smart_low_polybooleanNoEnable smart low poly optimization. Default: false
generate_partsbooleanNoGenerate separate parts. *generate_parts* is not compatible with *texture=true* and *pbr=true*, set both to false to enable generating in parts. Default: false
auto_sizebooleanNoAutomatically determine model size. Default: false

Multiview to Model

Generate a 3D model from multiple views (up to 4 images).

POST
https://cloud.unlimited3d.com/api/thirdParty/generate-model/multiview-to-model

Headers Parameters

NameTypeRequiredDescription
secret-keystringYesYour secret key
public-keystringYesYour public key

Body Parameters

NameTypeRequiredDescription
model_versionstringYesModel version. Options: Julian-6.0-NXT, Julian-5.0-NXT, Julian-4.2-NXT
filenamesarrayYesArray of 4 image filenames (must end with .jpeg, .jpg, or .png). At least 2 images required. Direction of images should be in order: FRONT, LEFT, BACK, RIGHT
texturebooleanNoWhether to generate texture. Default: true
pbrbooleanNoWhether to generate PBR materials. If this option is set to true, texture will be ignored and used as true. Default: true
texture_qualitystringNoTexture quality. Options: detailed, standard. Default: standard
geometry_qualitystringNoGeometry quality. Options: detailed, standard. Default: standard
face_limitintegerNoMaximum number of faces. If this value is not set, the face limit will be adaptively determined. If smart_low_poly is true, it should be 1k ~ 20k.
smart_low_polybooleanNoEnable smart low poly optimization. Default: false
generate_partsbooleanNoGenerate separate parts. *generate_parts* is not compatible with *texture=true* and *pbr=true*, set both to false to enable generating in parts. Default: false
auto_sizebooleanNoAutomatically determine model size. Default: false


Julian HyperMesh

Text to Model

Generate a 3D model from text description.

POST
https://cloud.unlimited3d.com/api/thirdParty/generate-model/text-to-model

Headers Parameters

NameTypeRequiredDescription
secret-keystringYesYour secret key
public-keystringYesYour public key

Body Parameters

NameTypeRequiredDescription
model_versionstringYesMust be set to: Julian-HyperMesh
promptstringYesText description of the model to generate (max 1024 characters)
negative_promptstringNoText describing what to avoid (max 255 characters)
texturebooleanNoWhether to generate texture. Default: true
pbrbooleanNoWhether to generate PBR materials. If this option is set to true, texture will be ignored and used as true. Default: true
texture_qualitystringNoTexture quality. Options: detailed, standard. Default: standard
face_limitintegerNoMaximum number of faces. If this value is not set, the face limit will be adaptively determined. The range should be 48 ~ 20000.
auto_sizebooleanNoAutomatically determine model size. Default: false
export_uvbooleanNo Controls whether UV unwrapping is performed during generation. Set to false to speed up generation. Default: true

Image to Model

Generate a 3D model from a single image.

POST
https://cloud.unlimited3d.com/api/thirdParty/generate-model/image-to-model

Headers Parameters

NameTypeRequiredDescription
secret-keystringYesYour secret key
public-keystringYesYour public key

Body Parameters

NameTypeRequiredDescription
model_versionstringYesMust be set to: Julian-HyperMesh
filenamestringYesName of the uploaded image file (must end with .jpeg, .jpg, or .png)
texturebooleanNoWhether to generate texture. Default: true
pbrbooleanNoWhether to generate PBR materials. If this option is set to true, texture will be ignored and used as true. Default: true
texture_qualitystringNoTexture quality. Options: detailed, standard. Default: standard
face_limitintegerNoMaximum number of faces. If this value is not set, the face limit will be adaptively determined. The range should be 48 ~ 20000.
auto_sizebooleanNoAutomatically determine model size. Default: false

Multiview to Model

Generate a 3D model from multiple views (up to 4 images).

POST
https://cloud.unlimited3d.com/api/thirdParty/generate-model/multiview-to-model

Headers Parameters

NameTypeRequiredDescription
secret-keystringYesYour secret key
public-keystringYesYour public key

Body Parameters

NameTypeRequiredDescription
model_versionstringYesMust be set to: Julian-HyperMesh
filenamesarrayYesArray of 4 image filenames (must end with .jpeg, .jpg, or .png). At least 2 images required. Direction of images should be in order: FRONT, LEFT, BACK, RIGHT
texturebooleanNoWhether to generate texture. Default: true
pbrbooleanNoWhether to generate PBR materials. If this option is set to true, texture will be ignored and used as true. Default: true
texture_qualitystringNoTexture quality. Options: detailed, standard. Default: standard
face_limitintegerNoMaximum number of faces. If this value is not set, the face limit will be adaptively determined. The range should be 48 ~ 20000.
auto_sizebooleanNoAutomatically determine model size. Default: false


Texture Model

Apply or regenerate texture on an existing generated model.

The generated model being textured needs to be generated with version ≥ Julian 4.2 NXT.

POST
https://cloud.unlimited3d.com/api/thirdParty/generate-model/texture-model/{id}

Headers Parameters

NameTypeRequiredDescription
secret-keystringYesYour secret key
public-keystringYesYour public key

URL Parameters

NameTypeRequiredDescription
idstringYesID of the generated model

Body Parameters

NameTypeRequiredDescription
model_versionstringYesModel version. Options: Julian-4.2-NXT, Julian-5.0-NXT
texture_prompt_textstringNoText prompt for texture generation (max 1024 characters). Required if no texture_prompt_image. Cannot be used with texture_prompt_image.
texture_prompt_imagestringNoFilename of texture prompt image (must end with .jpeg, .jpg, or .png). Required if no texture_prompt_text. Cannot be used with texture_prompt_text.
style_imagestringNoFilename of style reference image (must end with .jpeg, .jpg, or .png)
texturebooleanNoWhether to generate texture. Default: true
texture_qualitystringNoTexture quality. Options: detailed, standard. Default: standard
texture_alignmentstringNoTexture alignment. Options: original_image, geometry. Default: original_image
pbrbooleanNoWhether to generate PBR materials. If this option is set to true, texture will be ignored and used as true. Default: true
bakebooleanNoWhether to bake texture. Default: true
Upscale texture, PBR
  • When texture_quality = detailed, texture = false and pbr = false - it will upscale the texture on your model to 4K. Please note that PBR material will be removed. Only available for version Julian-5.0-NXT.
  • When texture_quality = detailed, texture = false and pbr = true - it will generate pbr with current texture.


Mesh Editing

Mesh Segmentation

Segment a generated model into parts.

POST
https://cloud.unlimited3d.com/api/thirdParty/generate-model/mesh-segmentation/{id}

Headers Parameters

NameTypeRequiredDescription
secret-keystringYesYour secret key
public-keystringYesYour public key

URL Parameters

NameTypeRequiredDescription
idstringYesID of the generated model

Body Parameters

NameTypeRequiredDescription
model_versionstringNoModel version. Options: Julian-v1.0-MeshX

Mesh Completion

POST
https://cloud.unlimited3d.com/api/thirdParty/generate-model/mesh-completion/{id}

Headers Parameters

NameTypeRequiredDescription
secret-keystringYesYour secret key
public-keystringYesYour public key

URL Parameters

NameTypeRequiredDescription
idstringYesID of the generated model

Body Parameters

NameTypeRequiredDescription
model_versionstringNoModel version. Options: Julian-v1.0-MeshX
part_namesarrayNoThe list of part names referred from Mesh Segmentation to be completed. The default value is all part names generated from segmentation


Import Model

Import an existing GLB model for processing.

POST
https://cloud.unlimited3d.com/api/thirdParty/generate-model/import-model

Headers Parameters

NameTypeRequiredDescription
secret-keystringYesYour secret key
public-keystringYesYour public key

Body Parameters

NameTypeRequiredDescription
filenamestringYesName of the GLB file to import (must end with .glb)


Animation

Animate Prerig Check

Check if a model is ready for rigging animation.

POST
https://cloud.unlimited3d.com/api/thirdParty/generate-model/animate-prerigcheck/{id}

Headers Parameters

NameTypeRequiredDescription
secret-keystringYesYour secret key
public-keystringYesYour public key

URL Parameters

NameTypeRequiredDescription
idstringYesID of the generated model

Animate Rig

Apply rigging to a generated model.

POST
https://cloud.unlimited3d.com/api/thirdParty/generate-model/animate-rig/{id}

Headers Parameters

NameTypeRequiredDescription
secret-keystringYesYour secret key
public-keystringYesYour public key

URL Parameters

NameTypeRequiredDescription
idstringYesID of the generated model

Body Parameters

NameTypeRequiredDescription
model_versionstringNoModel version. Options: Julian-v2.5-RigX, Julian-v2.0-RigX, Julian-v1.0-RigX. Default: Julian-v1.0-RigX
rig_typestringNo Rig type - You can obtain the appropriate value for this parameter by first running a pre-rig check. Options: biped, quadruped, hexapod, octopod, avian, serpentine, aquatic. Default: biped
Versions

Julian-v1.0-RigX version is only compatible with biped rig type.


Animate Retarget

Apply animation retargeting to a rigged model.

POST
https://cloud.unlimited3d.com/api/thirdParty/generate-model/animate-retarget/{id}

Headers Parameters

NameTypeRequiredDescription
secret-keystringYesYour secret key
public-keystringYesYour public key

URL Parameters

NameTypeRequiredDescription
idstringYesID of the generated model

Body Parameters

NameTypeRequiredDescription
animationstringNoSingle animation preset. Cannot be used with animations. Required if no animations
animationsarrayNoArray of animation presets. Cannot be used with animation.
bake_animationbooleanNoWhether to bake the animation. Default: true
export_with_geometrybooleanNoWhether to export with geometry. Default: true
animate_in_placebooleanNoWhether to animate in place. Default: false
available animations
Julian-v1.0-RigX (only biped type)
  • preset:biped:agree
  • preset:biped:angry_01
  • preset:biped:angry_02
  • preset:biped:angry_03
  • preset:biped:basketball_shot
  • preset:biped:bow
  • preset:biped:box_01
  • preset:biped:box_02
  • preset:biped:box_03
  • preset:biped:cast_a_spell
  • preset:biped:cheer
  • preset:biped:chop
  • preset:biped:clap
  • preset:biped:climb
  • preset:biped:complain_01
  • preset:biped:complain_02
  • preset:biped:cross_body_crunch
  • preset:biped:crossover_dribble
  • preset:biped:cry
  • preset:biped:dance_01
  • preset:biped:dance_02
  • preset:biped:dance_03
  • preset:biped:dance_04
  • preset:biped:dance_05
  • preset:biped:dance_06
  • preset:biped:defeat_02
  • preset:biped:defeat_03
  • preset:biped:depressed
  • preset:biped:dig
  • preset:biped:dive
  • preset:biped:dribble
  • preset:biped:fall
  • preset:biped:fire
  • preset:biped:flee_01
  • preset:biped:flee_02
  • preset:biped:flip
  • preset:biped:fold_arms
  • preset:biped:football_catch
  • preset:biped:football_save
  • preset:biped:football_pass
  • preset:biped:freaky
  • preset:biped:frightened
  • preset:biped:front_kick_01
  • preset:biped:front_kick_02
  • preset:biped:frustrated_01
  • preset:biped:frustrated_02
  • preset:biped:golf
  • preset:biped:greet_01
  • preset:biped:greet_02
  • preset:biped:greet_03
  • preset:biped:greet_04
  • preset:biped:heart_pose
  • preset:biped:hit_to_body_01
  • preset:biped:hit_to_body_02
  • preset:biped:hit_to_head
  • preset:biped:hit_to_side
  • preset:biped:hit_to_stomach
  • preset:biped:hug
  • preset:biped:hurt
  • preset:biped:idle
  • preset:biped:jump_down
  • preset:biped:jump
  • preset:biped:jump_rope_01
  • preset:biped:jump_rope_02
  • preset:biped:laugh_01
  • preset:biped:laugh_02
  • preset:biped:lift_heavy
  • preset:biped:look_around
  • preset:biped:make_a_call_01
  • preset:biped:make_a_call_02
  • preset:biped:pitch_baseball
  • preset:biped:play_mobile_game
  • preset:biped:play_video_game
  • preset:biped:press-up
  • preset:biped:run_upstairs
  • preset:biped:run
  • preset:biped:scared_01
  • preset:biped:scared_02
  • preset:biped:scratch
  • preset:biped:shoot
  • preset:biped:shovel
  • preset:biped:sing_01
  • preset:biped:sing_02
  • preset:biped:sing_03
  • preset:biped:sing_04
  • preset:biped:sit
  • preset:biped:slash
  • preset:biped:sob
  • preset:biped:standing_relax
  • preset:biped:surf
  • preset:biped:swagger
  • preset:biped:swim
  • preset:biped:turn
  • preset:biped:victory_celebration
  • preset:biped:volleyball
  • preset:biped:wait
  • preset:biped:walk
  • preset:biped:warm_up
  • preset:biped:wave_goodbye_01
  • preset:biped:wave_goodbye_02
Julian-v2.0-RigX and Julian-v2.5-RigX
  • preset:idle
  • preset:walk
  • preset:run
  • preset:dive
  • preset:climb
  • preset:jump
  • preset:slash
  • preset:shoot
  • preset:hurt
  • preset:fall
  • preset:turn
  • preset:quadruped:walk
  • preset:hexapod:walk
  • preset:octopod:walk
  • preset:serpentine:march
  • preset:aquatic:march


Stylize Model

Apply stylization effects to a generated model.

POST
https://cloud.unlimited3d.com/api/thirdParty/generate-model/stylize-model/{id}

Headers Parameters

NameTypeRequiredDescription
secret-keystringYesYour secret key
public-keystringYesYour public key

URL Parameters

NameTypeRequiredDescription
idstringYesID of the generated model

Body Parameters

NameTypeRequiredDescription
stylestringYesStylization style. Options: lego, voxel, voronoi, minecraft
block_sizearrayNoGrid size (range: 32-128). Default is 80. Currently only for minecraft.


Convert Model

Convert a generated model to different format.

POST
https://cloud.unlimited3d.com/api/thirdParty/generate-model/convert-model/{id}

Headers Parameters

NameTypeRequiredDescription
secret-keystringYesYour secret key
public-keystringYesYour public key

URL Parameters

NameTypeRequiredDescription
idstringYesID of the generated model

Body Parameters

NameTypeRequiredDescription
formatstringYesOutput format. Options: GLTF, USDZ, FBX, OBJ, STL, 3MF
quadbooleanNoConvert to quads. GLTF and STL don't support quad faces, so enabling quad option will still do retopology and face limit, but the result model will store all the faces as triangles.
force_symmetrybooleanNoForce symmetry
face_limitintegerNoLimits the number of faced on the output model. Default: 10k
flatten_bottombooleanNoFlatten bottom of model
flatten_bottom_thresholdnumberNoBottom flatten depth. Default: 0.01
texture_sizeintegerNoSet the diffuse color texture size (in pixel). The default value is 2048(4096 for model_version>=Julian-3.5-NXT), and should be smaller than the default value.
texture_formatstringNoTexture format. Options: BMP, DPX, HDR, JPEG, OPEN_EXR, PNG, TARGA, TIFF, WEBP. The default value is JPEG, and for FBX is PNG.
pivot_to_center_bottombooleanNoMove pivot to center bottom. Default: false
scale_factorintegerNoScale factor. Default: 1
with_animationbooleanNoInclude animation. Default: true
pack_uvbooleanNoPack UVs. Default: false
bakebooleanNoBake textures/materials. Default: true
part_namesarrayNoArray of part names to include - the list of part names referred from Mesh Segmentation
animate_in_placebooleanNoAnimate in place. Default: false
export_vertex_colorsbooleanNoExport vertex colors. Default: false
export_orientationstringNoExport orientation. Options: +x, -x, -y, +y. Default: +x
fbx_presetstringNoFBX preset. Options: blender, 3dsmax, mixamo. Default: blender


Add to Solution

Add a generated model to a solution.

POST
https://cloud.unlimited3d.com/api/thirdParty/generate-model/add-to-solution/{id}

Headers Parameters

NameTypeRequiredDescription
secret-keystringYesYour secret key
public-keystringYesYour public key

URL Parameters

NameTypeRequiredDescription
idstringYesID of the generated model

Body Parameters

NameTypeRequiredDescription
project_idintegerNoID of the project
project_titlestringNoTitle for new project


Pricing

3D Generation

Julian Model Versions: v4.2, v5.0, v6.0
Without TextureStandard Texture
Text to 3D2035
Image to 3D3550
Multiview to 3D3550

Julian HyperMesh
Without TextureStandard Texture
Text to 3D5070
Image to 3D7085
Multiview to 3D7085

Julian 1.2 NXT
Text35
Image50

Image Generation

Image10

Advanced Generation Setup

This is added on top of the generation credits cost if selected

Low Poly20
Generate in parts35
Style10
HD Texture20
Detailed Geometry Quality35

Texture Generation

Standard Texture20
HD Texture35
Style Reference10

Segmentation and Parts Completion, Stylization, Conversion

Segmentation70
Part Completion85
Post Stylization35
Basic Conversion10
Advanced Conversion20

Rigging and Animation

Rig CheckFree
Rigging45
Retarget (per animation)20