Skip to main content
POST
Load Classical Data With Data Loading

Authorizations

HAIQU_API_KEY
string
query
required

Body

application/json

Define payload for MCP classical-to-quantum data loading jobs.

MCP-layer validation is limited to mode-specific required-key checks plus the BlockVectorLoading exclusivity rule implemented by :func:haiqu.api.mcp.data_loading.validation.validate_data_loading_payload.

Attributes: experiment_id: Parent experiment identifier for the data-loading job. name: Optional job name. dl_type: Data-loading mode selector. parameters: Mode-specific parameters forwarded to the backend. num_qubits: Optional qubit count. Required for DistributionLoading. distribution_name: Distribution identifier required for DistributionLoading.

parameters
Parameters · object
required

Mode-specific parameters. For DistributionLoading: distribution_name, num_qubits, interval_start, interval_end, loc, scale, num_layers, truncation_cutoff (+ optional scipy distribution shape args). For VectorLoading: data, num_layers, truncation_cutoff, fine_tuning_iterations. For BlockVectorLoading: data, (num_blocks or target_num_qubits), num_layers, truncation_cutoff, fine_tuning_iterations. For EntangledManifoldEmbedding: data, density, real, periodicity, num_layers, truncation_cutoff, fine_tuning_iterations. For MpsLoading: mps, shape, num_layers, truncation_cutoff, fine_tuning_iterations. For FunctionLoading: func (math expression string in the single variable x, e.g. exp(-x**2)), interval_start, interval_end, num_layers, truncation_cutoff, fine_tuning_iterations.

dl_type
enum<string>
required

Data loading mode. Use one of: DistributionLoading, VectorLoading, BlockVectorLoading, EntangledManifoldEmbedding, MpsLoading, FunctionLoading.

Available options:
DistributionLoading,
VectorLoading,
BlockVectorLoading,
EntangledManifoldEmbedding,
MpsLoading,
FunctionLoading
experiment_id
string | null
default:""
name
string | null
default:""
description
string | null
default:""
num_qubits
integer | null

Optional qubit count. Required for DistributionLoading and FunctionLoading; optional for VectorLoading and EntangledManifoldEmbedding; ignored for BlockVectorLoading.

distribution_name
string | null

Required for DistributionLoading (e.g. norm, uniform, beta).

Response

Successful Response

Represent context payload returned after data-loading submission.

Attributes: context: Submission summary text including the created job ID and next polling step. This response model does not expose structured job_id or output circuit_id fields outside the text.

context
string
required