Model
idUnique model identifier. Use this value in job requests.
display_nameHuman-readable model name
descriptionModel description and recommended use case
providerModel provider
FileInfo
file_idUnique file identifier. Use this value in job requests.
filenameOriginal filename
sizeFile size in bytes
created_atupdated_atexpires_atFiles are automatically deleted after a period of time
UploadAppendRequest
dataBase64-encoded chunk of the file. Each chunk must not exceed 5MB of the original (pre-encoded) data.
Usage
total_input_charactersTotal number of input characters submitted
processed_input_charactersNumber of input characters actually processed
skipped_charactersNumber of input characters skipped (e.g. numeric segments)
output_charactersTotal number of output characters generated
vector_bytesVector data bytes (reserved for future use)
input_pagesNumber of pages in the input PDF. Present for jobs whose input is a PDF file.
JobCreateResponse
job_idUnique job identifier. Use this to poll for results.
modelstatusprogresscreated_atupdated_atexpires_atJobError
codemessagerequest_idStructFlowCreateJobRequest
modelModel ID obtained from GET /structflow/models
system_promptInstruction describing what structured data to extract and how
example_outputA JSON object showing the desired output structure with example values
List of input records to process. Mutually exclusive with 'file_id'.
file_idFile ID of a pre-uploaded JSONL file (one JSON record per line), obtained from POST /files. Mutually exclusive with 'inputs'. When used, results are returned as an 'output_file_id' instead of inline 'results'.
StructFlowJobSummary
job_idmodelstatusprogresscreated_atupdated_atcompleted_atexpires_atoutput_file_idFile ID of the output JSONL file. Present only for jobs submitted with 'file_id' input and status is completed.
StructFlowJobDetail
job_idmodelstatusprogressResult summary. Present only when status is completed AND the job was submitted with 'inputs' (inline).
Extracted data per input record. Present only when status is completed AND the job was submitted with 'inputs' (inline). Each record may independently succeed or fail. For jobs submitted with 'file_id', use 'output_file_id' to download the results as a JSONL file.
Job-level error. Present only when job status is failed.
created_atupdated_atcompleted_atexpires_atoutput_file_idFile ID of the output JSONL file. Present only when status is completed AND the job was submitted with 'file_id' input. Each line contains either the extracted JSON for a successful record, or an object with a reserved '$error' key (e.g. {"$error":{"code":"...","message":"..."}}) for a failed record. Download via GET /files/{output_file_id}/content.
RefineLoopCreateJobRequest
modelModel ID obtained from GET /refineloop/models
file_idFile ID of the XLIFF file to process, obtained from POST /files
exclude_numeric_segmentsIf true, segments containing only numbers are skipped
remove_hyphenationIf true, hyphenation in source text is removed before processing
max_revisionsMaximum number of revision iterations per segment (1-10)
domainSubject domain to guide translation review (e.g. "IR", "medical", "legal")
note_languageLanguage code for revision notes written by the AI (e.g. "ja", "en", "ko"). Defaults to the source language of the XLIFF file if not specified.
output_modeControls what is included in the output XLIFF
custom_instructionsAdditional instructions appended to the AI's base prompt
RefineLoopJobSummary
job_idfile_idInput file ID
modelstatusprogresscreated_atupdated_atcompleted_atexpires_atRefineLoopJobDetail
job_idfile_idInput file ID
modelstatusprogressoutput_file_idFile ID of the refined XLIFF output. Present only when status is completed. Download via GET /files/{output_file_id}/content.
Job-level error. Present only when job status is failed.
created_atupdated_atcompleted_atexpires_atEngine
idUnique engine identifier. Use this value in job requests.
display_nameHuman-readable engine name
providerEngine provider
descriptionEngine description and recommended use case
List of supported input/output format combinations
List of supported OCR languages
RenderOCRCreateJobRequest
engineEngine ID obtained from GET /renderocr/engines
file_idFile ID of the input file to process, obtained from POST /files
languagesList of language codes for OCR recognition. Currently only the first language is used.
output_formatOutput document format
RenderOCRJobSummary
job_idfile_idInput file ID
enginestatusprogresscreated_atupdated_atcompleted_atexpires_atRenderOCRJobDetail
job_idfile_idInput file ID
enginestatusprogressoutput_file_idFile ID of the converted document output. Present only when status is completed. Download via GET /files/{output_file_id}/content.
Job-level error. Present only when job status is failed.
created_atupdated_atcompleted_atexpires_atCastDocCreateJobRequest
engineEngine ID obtained from GET /castdoc/engines
file_idFile ID of the input PDF file to process, obtained from POST /files
output_formatOutput document format
CastDocJobSummary
job_idfile_idInput file ID
enginestatusprogresscreated_atupdated_atcompleted_atexpires_atCastDocJobDetail
job_idfile_idInput file ID
enginestatusprogressoutput_file_idFile ID of the converted document output. Present only when status is completed. Download via GET /files/{output_file_id}/content.
Job-level error. Present only when job status is failed.
created_atupdated_atcompleted_atexpires_atExtractDocCreateJobRequest
engineEngine ID obtained from GET /extractdoc/engines
file_idFile ID of the input file to process, obtained from POST /files. Supported input formats: PDF, DOCX, XLSX, PPTX. The input format is automatically detected from the uploaded file.
output_formatOutput format. Use 'text' for plain text, or 'jsonl' for a single-line JSON object compatible with StructFlow input.
ExtractDocJobSummary
job_idfile_idInput file ID
enginestatusprogresscreated_atupdated_atcompleted_atexpires_atExtractDocJobDetail
job_idfile_idInput file ID
enginestatusprogressoutput_file_idFile ID of the extracted output. Present only when status is completed. Download via GET /files/{output_file_id}/content.
Job-level error. Present only when job status is failed.
created_atupdated_atcompleted_atexpires_at
