Get a weights upload URL

Returns a presigned URL for uploading one weight file of a release in a single PUT. Send the bytes with Content-Type: application/octet-stream and a Content-Length equal to size. The URL is valid for one hour. For files over 5 GiB, use the multipart upload.

With sha256 set (and force unset), the server first looks for an identical file in an earlier release of the same model. When it finds one, the response has copied: true and no URL: skip the upload, and the file is copied at finalize. from_release restricts that search to one release.

After every file is uploaded, call POST .../weights/finalize. The release must be registered first. Callable by an account_admin or developer of the owning account when model serving is enabled for the account. The CLI equivalent is reactor weights upload.

POST

models

{id}

releases

{release}

weights

Get a weights upload URL

curl --request POST \
  --url https://api.reactor.inc/models/{id}/releases/{release}/weights \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "name": "model.safetensors",
  "size": 4294967296,
  "mime_type": "application/octet-stream",
  "sha256": "9f86d081884c7d659a2feaa0c55ad015a3bf4f1b2b0b822cd15d6c15b0f00a08"
}
'

import requests

url = "https://api.reactor.inc/models/{id}/releases/{release}/weights"

payload = {
    "name": "model.safetensors",
    "size": 4294967296,
    "mime_type": "application/octet-stream",
    "sha256": "9f86d081884c7d659a2feaa0c55ad015a3bf4f1b2b0b822cd15d6c15b0f00a08"
}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    name: 'model.safetensors',
    size: 4294967296,
    mime_type: 'application/octet-stream',
    sha256: '9f86d081884c7d659a2feaa0c55ad015a3bf4f1b2b0b822cd15d6c15b0f00a08'
  })
};

fetch('https://api.reactor.inc/models/{id}/releases/{release}/weights', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.reactor.inc/models/{id}/releases/{release}/weights",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'name' => 'model.safetensors',
    'size' => 4294967296,
    'mime_type' => 'application/octet-stream',
    'sha256' => '9f86d081884c7d659a2feaa0c55ad015a3bf4f1b2b0b822cd15d6c15b0f00a08'
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>",
    "Content-Type: application/json"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://api.reactor.inc/models/{id}/releases/{release}/weights"

	payload := strings.NewReader("{\n  \"name\": \"model.safetensors\",\n  \"size\": 4294967296,\n  \"mime_type\": \"application/octet-stream\",\n  \"sha256\": \"9f86d081884c7d659a2feaa0c55ad015a3bf4f1b2b0b822cd15d6c15b0f00a08\"\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("Authorization", "Bearer <token>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://api.reactor.inc/models/{id}/releases/{release}/weights")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"name\": \"model.safetensors\",\n  \"size\": 4294967296,\n  \"mime_type\": \"application/octet-stream\",\n  \"sha256\": \"9f86d081884c7d659a2feaa0c55ad015a3bf4f1b2b0b822cd15d6c15b0f00a08\"\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.reactor.inc/models/{id}/releases/{release}/weights")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"name\": \"model.safetensors\",\n  \"size\": 4294967296,\n  \"mime_type\": \"application/octet-stream\",\n  \"sha256\": \"9f86d081884c7d659a2feaa0c55ad015a3bf4f1b2b0b822cd15d6c15b0f00a08\"\n}"

response = http.request(request)
puts response.read_body

{
  "presigned_url": "https://storage.example.com/partners/8c8b7e12/weights/your-model/7b3f1bc2/v1.2.3-gabcdef0/files/model.safetensors?X-Signature=...",
  "path": "partners/8c8b7e12-a4c1-4627-b0a0-5d2e9f3a7b61/weights/your-model/7b3f1bc2-a4e5-4d78-b9c1-0e6c2f9a1d34/v1.2.3-gabcdef0/files/model.safetensors"
}

Authorizations

Authorization

string

header

required

A Reactor API key (rk_...), sent as Authorization: Bearer rk_.... Keep it on a server.

Path Parameters

string<uuid>

required

The model's ID (not its project ID). Find it with GET /models?name=your-org/your-model.

release

string

required

The release tag, such as v1.2.3-gabcdef0.

Example:

"v1.2.3-gabcdef0"

Body

application/json

name

string

required

The file's path in the bundle; may include subdirectories.

Example:

"model.safetensors"

size

integer<int64>

required

The file size in bytes. The upload must match it.

Required range: x >= 0

mime_type

enum<string>

required

Available options:

application/octet-stream

kind

enum<string>

default:file

Available options:

file

sha256

string

Hex SHA-256 of the file, to look for an identical file in earlier releases.

force

boolean

default:false

Skip the identical-file lookup and always upload.

from_release

string

Look for identical files only in this release.

Response

An upload URL, or a server-side copy in place of an upload.

path

string

required

The file's storage key.

presigned_url

string<uri>

PUT the file here. Absent when copied is true.

copied

boolean

true when an identical file was found; skip the upload.

source_path

string

The identical file that will be copied.

⌘I

Get a weights upload URL

curl --request POST \
  --url https://api.reactor.inc/models/{id}/releases/{release}/weights \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "name": "model.safetensors",
  "size": 4294967296,
  "mime_type": "application/octet-stream",
  "sha256": "9f86d081884c7d659a2feaa0c55ad015a3bf4f1b2b0b822cd15d6c15b0f00a08"
}
'

import requests

url = "https://api.reactor.inc/models/{id}/releases/{release}/weights"

payload = {
    "name": "model.safetensors",
    "size": 4294967296,
    "mime_type": "application/octet-stream",
    "sha256": "9f86d081884c7d659a2feaa0c55ad015a3bf4f1b2b0b822cd15d6c15b0f00a08"
}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    name: 'model.safetensors',
    size: 4294967296,
    mime_type: 'application/octet-stream',
    sha256: '9f86d081884c7d659a2feaa0c55ad015a3bf4f1b2b0b822cd15d6c15b0f00a08'
  })
};

fetch('https://api.reactor.inc/models/{id}/releases/{release}/weights', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.reactor.inc/models/{id}/releases/{release}/weights",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'name' => 'model.safetensors',
    'size' => 4294967296,
    'mime_type' => 'application/octet-stream',
    'sha256' => '9f86d081884c7d659a2feaa0c55ad015a3bf4f1b2b0b822cd15d6c15b0f00a08'
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>",
    "Content-Type: application/json"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://api.reactor.inc/models/{id}/releases/{release}/weights"

	payload := strings.NewReader("{\n  \"name\": \"model.safetensors\",\n  \"size\": 4294967296,\n  \"mime_type\": \"application/octet-stream\",\n  \"sha256\": \"9f86d081884c7d659a2feaa0c55ad015a3bf4f1b2b0b822cd15d6c15b0f00a08\"\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("Authorization", "Bearer <token>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://api.reactor.inc/models/{id}/releases/{release}/weights")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"name\": \"model.safetensors\",\n  \"size\": 4294967296,\n  \"mime_type\": \"application/octet-stream\",\n  \"sha256\": \"9f86d081884c7d659a2feaa0c55ad015a3bf4f1b2b0b822cd15d6c15b0f00a08\"\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.reactor.inc/models/{id}/releases/{release}/weights")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"name\": \"model.safetensors\",\n  \"size\": 4294967296,\n  \"mime_type\": \"application/octet-stream\",\n  \"sha256\": \"9f86d081884c7d659a2feaa0c55ad015a3bf4f1b2b0b822cd15d6c15b0f00a08\"\n}"

response = http.request(request)
puts response.read_body

{
  "presigned_url": "https://storage.example.com/partners/8c8b7e12/weights/your-model/7b3f1bc2/v1.2.3-gabcdef0/files/model.safetensors?X-Signature=...",
  "path": "partners/8c8b7e12-a4c1-4627-b0a0-5d2e9f3a7b61/weights/your-model/7b3f1bc2-a4e5-4d78-b9c1-0e6c2f9a1d34/v1.2.3-gabcdef0/files/model.safetensors"
}

Get started

SDK Reference

CLI Reference

Platform API Reference

Endpoints

Get a weights upload URL

Authorizations

Path Parameters

Body

Response