Create Experiment | Humanloop Docs

1 import requests 2 3 url = "https://api.humanloop.com/v4/completion-experiment" 4 5 response = requests.post(url) 6 7 print(response.json())

1 { 2 "data": [ 3 { 4 "id": "id", 5 "index": 1, 6 "output": "output", 7 "raw_output": "raw_output", 8 "inputs": { 9 "key": "value" 10 }, 11 "model_config_id": "model_config_id", 12 "finish_reason": "finish_reason", 13 "tool_results": [ 14 { 15 "id": "id", 16 "name": "name", 17 "signature": "signature", 18 "result": "result" 19 } 20 ] 21 } 22 ], 23 "provider_responses": [ 24 { 25 "key": "value" 26 } 27 ], 28 "project_id": "project_id", 29 "num_samples": 1, 30 "logprobs": 1, 31 "suffix": "suffix", 32 "user": "user", 33 "usage": { 34 "prompt_tokens": 1, 35 "generation_tokens": 1, 36 "total_tokens": 1, 37 "reasoning_tokens": 1 38 }, 39 "metadata": { 40 "key": "value" 41 }, 42 "provider_request": { 43 "key": "value" 44 }, 45 "session_id": "session_id" 46 }

Response

datalist of objects

Array containing the generation responses.

provider_responseslist of any

The raw responses returned by the model provider.

project_idstringOptional

Unique identifier of the parent project. Will not be provided if the request was made without providing a project name or id

num_samplesintegerOptionalDefaults to 1

How many completions to make for each set of inputs.

logprobsintegerOptional

Include the log probabilities of the top n tokens in the provider_response

suffixstringOptional

The suffix that comes after a completion of inserted text. Useful for completions that act like inserts.

userstringOptional

End-user ID passed through to provider call.

usageobjectOptional

Counts of the number of tokens used and related stats.

metadatamap from strings to anyOptional

Any additional metadata to record.

provider_requestmap from strings to anyOptional

The raw request sent to the model provider.

session_idstringOptional

ID of the session if it belongs to one.