Skip to main content
Docs

Search guides and API endpoints, for example “Idempotency-Key” or “submit job”.

    Concepts

    Inference

    Predict molecular properties with a public MPNN model or one you trained, counted per molecule against a monthly allowance.

    Updated October 1, 2026

    On this page

    Inference runs a trained property-prediction model on your molecules. Today the model family is MPNN (message-passing neural networks, Chemprop-style). You can use:

    Like utilities, inference is not charged to your wallet. Each molecule counts toward your plan's monthly inference allowance, and at the limit submits return 403.

    Run a prediction

    Submit an inference request with model_type, model_name, and a payload (set is_public_model to true for a public model; leave it false for one you trained), then poll Get inference status and read Get an inference result. Submit a batch of inference requests sends several requests at once.

    from cognichem_client import CogniChem
     
    client = CogniChem.from_env()
    print(client.inference.models.mpnn.public())  # pick a model_name
     
    result = client.inference.run(
        "mpnn",
        "MODEL_NAME",
        {"input_data": ["CCO", "c1ccccc1O"], "input_format": "smiles", "is_public_model": True},
    )
    print(result.data)

    Payload

    mpnn Property prediction with a trained MPNN (Chemprop-style) model: a public model or one you trained with the train-mpnn job.

    Payload fields
    FieldTypeDescription
    input_data[]requiredstring[]

    Limits: min items 1, max items 1000

    input_formatrequiredstring

    One of: "fasta", "helm", "mol2block", "molblock", "mrvblock", "pdbblock", "scsrblock", "selfies", "sequence", "smarts", "smiles", "tplblock", "xyzblock", "inchi"

    is_public_modelboolean

    Default: false

    return_contributionsboolean

    Default: false

    return_coordinatesboolean

    Default: false

    generate_3dboolean
    add_hydrogensboolean
    remove_hydrogensboolean
    batch_sizeinteger

    Default: 32Limits: ≥ 1, ≤ 512