Files - Portkey Docs

Uploading Files

Python
NodeJS
REST
OpenAI NodeJS
OpenAI Python

from portkey_ai import Portkey

# Initialize the Portkey client
portkey = Portkey(
    api_key="PORTKEY_API_KEY",  # Replace with your Portkey API key
    provider="@PROVIDER",   
    provider="fireworks-ai",
    fireworks_account_id="FIREWORKS_ACCOUNT_ID"
)

upload_file_response = portkey.files.create(
  purpose="batch",
  file=open("file.pdf", "rb")
)

print(upload_file_response)

import { Portkey } from 'portkey-ai';

// Initialize the Portkey client
const portkey = new Portkey({
    apiKey: "PORTKEY_API_KEY",  // Replace with your Portkey API key
    provider:"@PROVIDER",   
    provider: "fireworks-ai",
    fireworksAccountId: "FIREWORKS_ACCOUNT_ID"
});

const uploadFile = async () => {
  const file = await portkey.files.create({
    purpose: "batch",
    file: fs.createReadStream("file.pdf")
  });

  console.log(file);
}

await uploadFile();

# you can also use a provider from Model Catalog here
curl --location 'https://api.portkey.ai/v1/files' \
--header 'x-portkey-api-key: <portkey_api_key>' \
--header 'x-portkey-provider: fireworks-ai' \
--header 'Content-Type: application/json' \
--header 'x-portkey-fireworks-account-id: {YOUR_FIREWORKS_ACCOUNT_ID}' \
--form 'file=@"{YOUR_FILE_PATH}"',
--form 'purpose="batch"'

import OpenAI from 'openai'; // We're using the v4 SDK
import { PORTKEY_GATEWAY_URL, createHeaders } from 'portkey-ai'

const openai = new OpenAI({
  apiKey: 'OPENAI_API_KEY', // defaults to process.env["OPENAI_API_KEY"],
  baseURL: PORTKEY_GATEWAY_URL,
  defaultHeaders: createHeaders({
    provider: "fireworks-ai",
    apiKey: "PORTKEY_API_KEY", // defaults to process.env["PORTKEY_API_KEY"]
    fireworksAccountId: "FIREWORKS_ACCOUNT_ID"
  })
});

const uploadFile = async () => {
  const file = await openai.files.create({
    purpose: "batch",
    file: fs.createReadStream("file.pdf")
  });

  console.log(file);
}

await uploadFile();

from openai import OpenAI
from portkey_ai import PORTKEY_GATEWAY_URL, createHeaders

openai = OpenAI(
    api_key='OPENAI_API_KEY',
    base_url=PORTKEY_GATEWAY_URL,
    default_headers=createHeaders(
        provider="fireworks-ai",
        api_key="PORTKEY_API_KEY",
        fireworks_account_id="FIREWORKS_ACCOUNT_ID"
    )
)

upload_file_response = openai.files.create(
  purpose="batch",
  file=open("file.pdf", "rb")
)

print(upload_file_response)

Get File

Python
NodeJS
REST
OpenAI NodeJS
OpenAI Python

from portkey_ai import Portkey

# Initialize the Portkey client
portkey = Portkey(
    api_key="PORTKEY_API_KEY",  # Replace with your Portkey API key
    provider="@PROVIDER",   
    fireworks_account_id="FIREWORKS_ACCOUNT_ID"
)

file = portkey.files.retrieve(file_id="file_id")

print(file)

import { Portkey } from 'portkey-ai';

// Initialize the Portkey client
const portkey = new Portkey({
    apiKey: "PORTKEY_API_KEY",  // Replace with your Portkey API key
    provider:"@PROVIDER",   
    fireworksAccountId="FIREWORKS_ACCOUNT_ID",
});

const getFile = async () => {
  const file = await portkey.files.retrieve(file_id="file_id");

  console.log(file);
}

await getFile();

curl --location 'https://api.portkey.ai/v1/files/<file_id>' \
--header 'x-portkey-api-key: <portkey_api_key>' \
--header 'x-portkey-provider: @provider' \
--header 'x-portkey-fireworks-account-id: {YOUR_FIREWORKS_ACCOUNT_ID}'

import OpenAI from 'openai'; // We're using the v4 SDK
import { PORTKEY_GATEWAY_URL, createHeaders } from 'portkey-ai'

const openai = new OpenAI({
  apiKey: 'OPENAI_API_KEY', // defaults to process.env["OPENAI_API_KEY"],
  baseURL: PORTKEY_GATEWAY_URL,
  defaultHeaders: createHeaders({
    provider: "fireworks-ai",
    apiKey: "PORTKEY_API_KEY", // defaults to process.env["PORTKEY_API_KEY"]
    fireworksAccountId="FIREWORKS_ACCOUNT_ID",
  })
});

const getFile = async () => {
  const file = await openai.files.retrieve(file_id="file_id");

  console.log(file);
}

await getFile();

from openai import OpenAI
from portkey_ai import PORTKEY_GATEWAY_URL, createHeaders

openai = OpenAI(
    api_key='OPENAI_API_KEY',
    base_url=PORTKEY_GATEWAY_URL,
    default_headers=createHeaders(
        provider="fireworks-ai",
        api_key="PORTKEY_API_KEY",
        fireworks_account_id="FIREWORKS_ACCOUNT_ID",
    )
)

file = openai.files.retrieve(file_id="file_id")

print(file)

Get File Content

Python
NodeJS
REST
OpenAI NodeJS
OpenAI Python

from portkey_ai import Portkey

# Initialize the Portkey client
portkey = Portkey(
    api_key="PORTKEY_API_KEY",  # Replace with your Portkey API key
    provider="@PROVIDER",   
    fireworks_account_id="FIREWORKS_ACCOUNT_ID",
)

file_content = portkey.files.content(file_id="file_id")

print(file_content)

import { Portkey } from 'portkey-ai';

// Initialize the Portkey client
const portkey = new Portkey({
    apiKey: "PORTKEY_API_KEY",  // Replace with your Portkey API key
    provider:"@PROVIDER",   
    fireworksAccountId="FIREWORKS_ACCOUNT_ID",
});

const getFileContent = async () => {
  const file_content = await portkey.files.content(file_id="file_id");

  console.log(file_content);
}

await getFileContent();

curl --location 'https://api.portkey.ai/v1/files/<file_id>/content' \
--header 'x-portkey-api-key: <portkey_api_key>' \
--header 'x-portkey-provider: @provider' \
--header 'x-portkey-fireworks-account-id: {YOUR_FIREWORKS_ACCOUNT_ID}'

import OpenAI from 'openai'; // We're using the v4 SDK
import { PORTKEY_GATEWAY_URL, createHeaders } from 'portkey-ai'

const openai = new OpenAI({
  apiKey: 'OPENAI_API_KEY', // defaults to process.env["OPENAI_API_KEY"],
  baseURL: PORTKEY_GATEWAY_URL,
  defaultHeaders: createHeaders({
    provider: "fireworks-ai",
    apiKey: "PORTKEY_API_KEY", // defaults to process.env["PORTKEY_API_KEY"]
    fireworksAccountId="FIREWORKS_ACCOUNT_ID",
  })
});

const getFileContent = async () => {
  const file_content = await openai.files.content(file_id="file_id");

  console.log(file_content);
}

await getFileContent();

from openai import OpenAI
from portkey_ai import PORTKEY_GATEWAY_URL, createHeaders

openai = OpenAI(
    api_key='OPENAI_API_KEY',
    base_url=PORTKEY_GATEWAY_URL,
    default_headers=createHeaders(
        provider="fireworks-ai",
        api_key="PORTKEY_API_KEY",
        fireworks_account_id="FIREWORKS_ACCOUNT_ID",
    )
)

file_content = openai.files.content(file_id="file_id")

print(file_content)

Fireworks Datasets API

Last modified on March 24, 2026