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


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