Citations Public Release and Increased Default Rate Limits

Announcements
1

We are excited to announce the public availability of citations in the Perplexity API. In addition, we have also increased our default rate limit for the sonar online models to 50 requests/min for all users.

Effective immediately, all API users will see citations returned as part of their requests by default. This is not a breaking change. The return_citations parameter will no longer have any effect.

2

That really sounds exciting! But am I the only one not seeing the citations returned? Also, it seems like they are not mentioned in the docs (Chat Completions - Perplexity), so it’s hard to tell whether I’m doing something wrong.

curl --request POST \
     --url https://api.perplexity.ai/chat/completions \
     --header 'accept: application/json' \
     --header 'authorization: Bearer ...' \
     --header 'content-type: application/json' \
     --data '{
  "model": "llama-3.1-sonar-small-128k-online",
  "messages": [
    {
      "role": "user",
      "content": "what is retinol?"
    }
  ]
}' | qj -C .
{
  "id": "8d2304b9-66f7-423e-9d9f-f53606b7ed6e",
  "model": "llama-3.1-sonar-small-128k-online",
  "created": 1731061926,
  "usage": {
    "prompt_tokens": 6,
    "completion_tokens": 308,
    "total_tokens": 314
  },
  "object": "chat.completion",
  "choices": [
    {
      "index": 0,
      "finish_reason": "stop",
      "message": {
        "role": "assistant",
        "content": "Retinol is a form of vitamin A, specifically a retinoid, which is derived from vitamin A. It is commonly used in skincare products to address various skin concerns, including aging, acne, and uneven skin tone. Here are the key points about retinol:\n\n- **Origin**: Retinol is a synthetic form of vitamin A, ensuring consistent quality and stability.\n- **Biological Role**: It plays a crucial role in vision, cellular development, maintenance of skin and mucous membranes, immune function, and reproductive development.\n- **Skin Benefits**: Retinol helps neutralize free radicals, promotes cell turnover, prevents collagen breakdown, and stimulates collagen and elastin production. This can reduce the appearance of fine lines, wrinkles, and enlarged pores, as well as improve skin texture and tone.\n- **Usage**: It is typically applied topically in various forms such as serums, gels, creams, and emollients. For best results, it is recommended to start with a gradual introduction to allow the skin to adjust to its effects.\n- **Side Effects**: Common side effects include dry, irritated, or itchy skin, redness, and peeling. It can also make the skin more sensitive to UV radiation, so using sunscreen is recommended.\n\nRetinol is widely recognized as a key ingredient in anti-aging skincare products due to its effectiveness in addressing various signs of skin aging and improving overall skin health."
      },
      "delta": {
        "role": "assistant",
        "content": ""
      }
    }
  ]
}

Am I missing something trivial here or is it simply needs some time to become available?

3

can we have more than 5 citations?