Meldport API

curl https://api.meldport.com/v1/chat/completions \
  -H "Authorization: Bearer $MELDPORT_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: request-123" \
  -d '{
    "model": "YOUR_MODEL_ID",
    "messages": [{"role": "user", "content": "Hello"}]
  }'

import os
import requests

response = requests.post(
    "https://api.meldport.com/v1/chat/completions",
    headers={
        "Authorization": f"Bearer {os.environ['MELDPORT_API_KEY']}",
        "Idempotency-Key": "request-123",
    },
    json={
        "model": "YOUR_MODEL_ID",
        "messages": [{"role": "user", "content": "Hello"}],
    },
)
print(response.json())

const response = await fetch(
  "https://api.meldport.com/v1/chat/completions",
  {
    method: "POST",
    headers: {
      Authorization: "Bearer " + process.env.MELDPORT_API_KEY,
      "Content-Type": "application/json",
      "Idempotency-Key": "request-123",
    },
    body: JSON.stringify({
      model: "YOUR_MODEL_ID",
      messages: [{ role: "user", content: "Hello" }],
    }),
  },
);
console.log(await response.json());

{
  "id": "req_01J...",
  "object": "chat.completion",
  "model": "meldport/qwen3.8-max",
  "choices": [
    {
      "index": 0,
      "message": {
        "role": "assistant",
        "content": "Hello"
      }
    }
  ],
  "usage": {
    "prompt_tokens": 8,
    "completion_tokens": 3,
    "total_tokens": 11
  }
}

curl -N https://api.meldport.com/v1/chat/completions \
  -H "Authorization: Bearer $MELDPORT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "YOUR_MODEL_ID",
    "stream": true,
    "stream_options": {"include_usage": true},
    "messages": [{"role": "user", "content": "Hello"}]
  }'

curl https://api.meldport.com/v1/media/configurations \
  -H "Authorization: Bearer $MELDPORT_API_KEY"

# Quote the exact prompt and options before reserving wallet credit
curl -X POST https://api.meldport.com/v1/media/quotes \
  -H "Authorization: Bearer $MELDPORT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"configuration_id":"<published-configuration-id>","prompt":"A quiet studio desk"}'

# Use the same prompt, options and uploaded asset IDs as the quote.
# Include billing_policy_version: actual-cost-v1 when returned by the quote.
# Create a job with a published configuration
curl -X POST https://api.meldport.com/v1/media/jobs \
  -H "Authorization: Bearer $MELDPORT_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: media-request-123" \
  -d '{"configuration_id":"<published-configuration-id>","prompt":"A quiet studio desk","accepted_customer_price_microusd":"<customer_price_microusd from quote>","accepted_maximum_reservation_microusd":"<maximum_reservation_microusd from quote>"}'

# Poll the job until it is succeeded or failed
curl https://api.meldport.com/v1/media/jobs/<job-id> \
  -H "Authorization: Bearer $MELDPORT_API_KEY"

{
  "job": {
    "id": "8f05b647-1a44-4f13-9a4e-7be283221ad2",
    "configuration_id": "e06a4324-3b43-4c55-ae84-c6a9b6a6d452",
    "state": "queued",
    "billing_state": "held",
    "maximum_charge_microusd": "125000",
    "output_asset_id": null
  },
  "idempotent": false
}

curl https://api.meldport.com/v1/media/configurations \
  -H "Authorization: Bearer $MELDPORT_API_KEY"

# Quote the exact prompt and options before reserving wallet credit
curl -X POST https://api.meldport.com/v1/media/quotes \
  -H "Authorization: Bearer $MELDPORT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"configuration_id":"<published-configuration-id>","prompt":"A quiet studio desk"}'

# Use the same prompt, options and uploaded asset IDs as the quote.
# Include billing_policy_version: actual-cost-v1 when returned by the quote.
# Create a job with a published configuration
curl -X POST https://api.meldport.com/v1/media/jobs \
  -H "Authorization: Bearer $MELDPORT_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: media-request-123" \
  -d '{"configuration_id":"<published-configuration-id>","prompt":"A quiet studio desk","accepted_customer_price_microusd":"<customer_price_microusd from quote>","accepted_maximum_reservation_microusd":"<maximum_reservation_microusd from quote>"}'

# Poll the job until it is succeeded or failed
curl https://api.meldport.com/v1/media/jobs/<job-id> \
  -H "Authorization: Bearer $MELDPORT_API_KEY"

{
  "job": {
    "id": "8f05b647-1a44-4f13-9a4e-7be283221ad2",
    "configuration_id": "e06a4324-3b43-4c55-ae84-c6a9b6a6d452",
    "state": "queued",
    "billing_state": "held",
    "maximum_charge_microusd": "125000",
    "output_asset_id": null
  },
  "idempotent": false
}

import {readFile} from "node:fs/promises";
import {createHash} from "node:crypto";
const api = "https://api.meldport.com";
const key = process.env.MELDPORT_API_KEY;
const image = await readFile("./input.png");
const response = await fetch(api + "/v1/media/assets/upload-url", {
  method: "POST", headers: {Authorization: `Bearer ${key}`, "Content-Type": "application/json"},
  body: JSON.stringify({configuration_id: "YOUR_CONFIGURATION_ID", modality: "image",
    content_type: "image/png", size_bytes: image.length,
    sha256: createHash("sha256").update(image).digest("hex")})
});
const upload = await response.json();
if (!response.ok) throw new Error(JSON.stringify(upload.error));
const stored = await fetch(upload.upload_url, {method: "PUT", headers: {"Content-Type": "image/png"}, body: image});
if (stored.status !== 201) throw new Error(`Upload failed: ${stored.status}`);
console.log(upload.asset_id);

const api = "https://api.meldport.com";
const key = process.env.MELDPORT_API_KEY;
const id = process.env.MELDPORT_JOB_ID;
const headers = {Authorization: `Bearer ${key}`};
const response = await fetch(api + "/v1/media/jobs/" + id, {headers});
const result = await response.json();
if (!response.ok) throw new Error(JSON.stringify(result.error));
if (result.job.state === "succeeded" && result.job.billing_state === "settled") {
  const response = await fetch(api + "/v1/media/jobs/" + id + "/download-url", {method: "POST", headers});
  const ticket = await response.json();
  if (!response.ok) throw new Error(JSON.stringify(ticket.error));
  console.log(new URL(ticket.download_url, api).href);
} else {
  console.log(result.job.state, result.job.error_code);
}